* Annotate scsiwmi.h.

svn path=/trunk/; revision=59973
This commit is contained in:
Amine Khaldi 2013-09-03 12:04:47 +00:00
parent 62b8ac070f
commit 962e2b35b9

View file

@ -20,8 +20,10 @@
*
*/
#ifndef __SCSIWMI_H
#define __SCSIWMI_H
#pragma once
#ifndef _SCSIWMI_
#define _SCSIWMI_
#include "srb.h"
@ -60,65 +62,77 @@ typedef struct _SCSIWMIGUIDREGINFO {
ULONG Flags;
} SCSIWMIGUIDREGINFO, *PSCSIWMIGUIDREGINFO;
typedef UCHAR
typedef
_Must_inspect_result_
UCHAR
(NTAPI *PSCSIWMI_QUERY_REGINFO)(
IN PVOID DeviceContext,
IN PSCSIWMI_REQUEST_CONTEXT RequestContext,
OUT PWCHAR *MofResourceName);
_In_ PVOID DeviceContext,
_In_ PSCSIWMI_REQUEST_CONTEXT RequestContext,
_Out_ PWCHAR *MofResourceName);
typedef BOOLEAN
typedef
_Must_inspect_result_
BOOLEAN
(NTAPI *PSCSIWMI_QUERY_DATABLOCK)(
IN PVOID Context,
IN PSCSIWMI_REQUEST_CONTEXT DispatchContext,
IN ULONG GuidIndex,
IN ULONG InstanceIndex,
IN ULONG InstanceCount,
IN OUT PULONG InstanceLengthArray,
IN ULONG BufferAvail,
OUT PUCHAR Buffer);
_In_ PVOID Context,
_In_ PSCSIWMI_REQUEST_CONTEXT DispatchContext,
_In_ ULONG GuidIndex,
_In_ ULONG InstanceIndex,
_In_ ULONG InstanceCount,
_Inout_ PULONG InstanceLengthArray,
_In_ ULONG BufferAvail,
_Out_writes_bytes_(BufferAvail) PUCHAR Buffer);
typedef BOOLEAN
typedef
_Must_inspect_result_
BOOLEAN
(NTAPI *PSCSIWMI_SET_DATABLOCK)(
IN PVOID DeviceContext,
IN PSCSIWMI_REQUEST_CONTEXT RequestContext,
IN ULONG GuidIndex,
IN ULONG InstanceIndex,
IN ULONG BufferSize,
IN PUCHAR Buffer);
_In_ PVOID DeviceContext,
_In_ PSCSIWMI_REQUEST_CONTEXT RequestContext,
_In_ ULONG GuidIndex,
_In_ ULONG InstanceIndex,
_In_ ULONG BufferSize,
_In_reads_bytes_(BufferSize) PUCHAR Buffer);
typedef BOOLEAN
typedef
_Must_inspect_result_
BOOLEAN
(NTAPI *PSCSIWMI_SET_DATAITEM)(
IN PVOID DeviceContext,
IN PSCSIWMI_REQUEST_CONTEXT RequestContext,
IN ULONG GuidIndex,
IN ULONG InstanceIndex,
IN ULONG DataItemId,
IN ULONG BufferSize,
IN PUCHAR Buffer);
_In_ PVOID DeviceContext,
_In_ PSCSIWMI_REQUEST_CONTEXT RequestContext,
_In_ ULONG GuidIndex,
_In_ ULONG InstanceIndex,
_In_ ULONG DataItemId,
_In_ ULONG BufferSize,
_In_reads_bytes_(BufferSize) PUCHAR Buffer);
typedef BOOLEAN
typedef
_Must_inspect_result_
BOOLEAN
(NTAPI *PSCSIWMI_EXECUTE_METHOD)(
IN PVOID DeviceContext,
IN PSCSIWMI_REQUEST_CONTEXT RequestContext,
IN ULONG GuidIndex,
IN ULONG InstanceIndex,
IN ULONG MethodId,
IN ULONG InBufferSize,
IN ULONG OutBufferSize,
IN OUT PUCHAR Buffer);
_In_ PVOID DeviceContext,
_In_ PSCSIWMI_REQUEST_CONTEXT RequestContext,
_In_ ULONG GuidIndex,
_In_ ULONG InstanceIndex,
_In_ ULONG MethodId,
_In_ ULONG InBufferSize,
_In_ ULONG OutBufferSize,
_Inout_updates_bytes_to_(InBufferSize, OutBufferSize) PUCHAR Buffer);
typedef enum _SCSIWMI_ENABLE_DISABLE_CONTROL {
ScsiWmiEventControl,
ScsiWmiDataBlockControl
} SCSIWMI_ENABLE_DISABLE_CONTROL;
typedef BOOLEAN
typedef
_Must_inspect_result_
BOOLEAN
(NTAPI *PSCSIWMI_FUNCTION_CONTROL)(
IN PVOID DeviceContext,
IN PSCSIWMI_REQUEST_CONTEXT RequestContext,
IN ULONG GuidIndex,
IN SCSIWMI_ENABLE_DISABLE_CONTROL Function,
IN BOOLEAN Enable);
_In_ PVOID DeviceContext,
_In_ PSCSIWMI_REQUEST_CONTEXT RequestContext,
_In_ ULONG GuidIndex,
_In_ SCSIWMI_ENABLE_DISABLE_CONTROL Function,
_In_ BOOLEAN Enable);
typedef struct _SCSIWMILIB_CONTEXT {
ULONG GuidCount;
@ -131,17 +145,18 @@ typedef struct _SCSIWMILIB_CONTEXT {
PSCSIWMI_FUNCTION_CONTROL WmiFunctionControl;
} SCSI_WMILIB_CONTEXT, *PSCSI_WMILIB_CONTEXT;
_Must_inspect_result_
SCSIPORTAPI
BOOLEAN
NTAPI
ScsiPortWmiDispatchFunction(
IN PSCSI_WMILIB_CONTEXT WmiLibInfo,
IN UCHAR MinorFunction,
IN PVOID DeviceContext,
IN PSCSIWMI_REQUEST_CONTEXT RequestContext,
IN PVOID DataPath,
IN ULONG BufferSize,
IN PVOID Buffer);
_In_ PSCSI_WMILIB_CONTEXT WmiLibInfo,
_In_ UCHAR MinorFunction,
_In_ PVOID DeviceContext,
_In_ PSCSIWMI_REQUEST_CONTEXT RequestContext,
_In_ PVOID DataPath,
_In_ ULONG BufferSize,
_In_ PVOID Buffer);
#define ScsiPortWmiFireAdapterEvent( \
HwDeviceExtension, \
@ -178,22 +193,22 @@ SCSIPORTAPI
VOID
NTAPI
ScsiPortWmiPostProcess(
IN PSCSIWMI_REQUEST_CONTEXT RequestContext,
IN UCHAR SrbStatus,
IN ULONG BufferUsed);
_Inout_ PSCSIWMI_REQUEST_CONTEXT RequestContext,
_In_ UCHAR SrbStatus,
_In_ ULONG BufferUsed);
SCSIPORTAPI
VOID
NTAPI
ScsiPortWmiFireLogicalUnitEvent(
IN PVOID HwDeviceExtension,
IN UCHAR PathId,
IN UCHAR TargetId,
IN UCHAR Lun,
IN LPGUID Guid,
IN ULONG InstanceIndex,
IN ULONG EventDataSize,
IN PVOID EventData);
_In_ PVOID HwDeviceExtension,
_In_ UCHAR PathId,
_In_ UCHAR TargetId,
_In_ UCHAR Lun,
_In_ LPGUID Guid,
_In_ ULONG InstanceIndex,
_In_ ULONG EventDataSize,
_In_ PVOID EventData);
#pragma pack(pop)
@ -201,4 +216,4 @@ ScsiPortWmiFireLogicalUnitEvent(
}
#endif
#endif /* __SCSIWMI_H */
#endif /* _SCSIWMI_ */