WDF_REQUEST_PARAMETERS構造体 (wdfrequest.h)
[KMDF と UMDF に適用]
WDF_REQUEST_PARAMETERS 構造体は、I/O 要求に関連付けられているパラメーターを受け取ります。
構文
typedef struct _WDF_REQUEST_PARAMETERS {
USHORT Size;
UCHAR MinorFunction;
WDF_REQUEST_TYPE Type;
union {
struct {
PIO_SECURITY_CONTEXT SecurityContext;
ULONG Options;
USHORT POINTER_ALIGNMENT FileAttributes;
USHORT ShareAccess;
ULONG POINTER_ALIGNMENT EaLength;
} Create;
struct {
size_t Length;
ULONG POINTER_ALIGNMENT Key;
LONGLONG DeviceOffset;
} Read;
struct {
size_t Length;
ULONG POINTER_ALIGNMENT Key;
LONGLONG DeviceOffset;
} Write;
struct {
size_t OutputBufferLength;
size_t POINTER_ALIGNMENT InputBufferLength;
ULONG POINTER_ALIGNMENT IoControlCode;
PVOID Type3InputBuffer;
} DeviceIoControl;
struct {
PVOID Arg1;
PVOID Arg2;
ULONG POINTER_ALIGNMENT IoControlCode;
PVOID Arg4;
} Others;
} Parameters;
} WDF_REQUEST_PARAMETERS, *PWDF_REQUEST_PARAMETERS;
メンバーズ
Size
この構造体のサイズ (バイト単位)。
MinorFunction
I/O 要求に関連付けられている IRP マイナー関数コード (存在する場合)。 一部の主要な関数コードには、マイナー関数コードが関連付けられています。
Type
I/O 要求の型を識別する WDF_REQUEST_TYPE型指定された値。
Parameters
IRP の主要な関数コードごとに一意のパラメーター。 このメンバーには、IO_STACK_LOCATION 構造体の Parameters メンバーのサブセットが含まれています。
Parameters.Create
IRP_MJ_CREATEのパラメーター。
Parameters.Create.SecurityContext
Parameters.Create.Options
Parameters.Create.FileAttributes
Parameters.Create.ShareAccess
Parameters.Create.EaLength
Parameters.Read
IRP_MJ_READのパラメーター。
Parameters.Read.Length
Parameters.Read.Key
Parameters.Read.DeviceOffset
Parameters.Write
IRP_MJ_WRITEのパラメーター。
Parameters.Write.Length
Parameters.Write.Key
Parameters.Write.DeviceOffset
Parameters.DeviceIoControl
IRP_MJ_DEVICE_CONTROL と IRP_MJ_INTERNAL_DEVICE_CONTROLのパラメーター。
Parameters.DeviceIoControl.OutputBufferLength
Parameters.DeviceIoControl.InputBufferLength
Parameters.DeviceIoControl.IoControlCode
Parameters.DeviceIoControl.Type3InputBuffer
Parameters.Others
このメンバーの使用は、ドライバー スタックによって定義されます。
Parameters.Others.Arg1
Parameters.Others.Arg2
Parameters.Others.IoControlCode
Parameters.Others.Arg4
備考
WDF_REQUEST_PARAMETERS 構造体は、WdfRequestGetParameters をするための入力として使用されます。 ドライバーは、WdfRequestGetParametersを呼び出す前に、この構造体を初期化する WDF_REQUEST_PARAMETERS_INIT を呼び出す必要があります。
必要条件
要件 | 価値 |
---|---|
最小 KMDF バージョン | 1.0 |
UMDF の最小バージョン を する | 2.0 |
ヘッダー | wdfrequest.h (Wdf.h を含む) |