структура WDF_REQUEST_PARAMETERS (wdfrequest.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Структура WDF_REQUEST_PARAMETERS получает параметры, связанные с запросом ввода-вывода.

Синтаксис

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

Дополнительный код функции IRP, связанный с запросом ввода-вывода. Некоторые основные коды функций связаны с дополнительными кодами функций.

Type

Значение WDF_REQUEST_TYPEтипа, определяющее тип запроса ввода-вывода.

Parameters

Параметры, уникальные для каждого основного кода функции IRP. Этот элемент содержит подмножество элемента "Параметры" структуры IO_STACK_LOCATION.

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. Драйверы должны вызывать WDF_REQUEST_PARAMETERS_INIT, чтобы инициализировать эту структуру, прежде чем вызывать WdfRequestGetParameters.

Требования

Требование	Ценность
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfrequest.h (включая Wdf.h)

См. также

IO_STACK_LOCATION

WDF_REQUEST_PARAMETERS_INIT

WdfRequestGetParameters

Поделиться через