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
Header	wdfrequest.h (Wdf.h を含む)

こちらもご覧ください

IO_STACK_LOCATION

WDF_REQUEST_PARAMETERS_INIT

WdfRequestGetParameters