estrutura WDF_REQUEST_PARAMETERS (wdfrequest.h)
[Aplica-se a KMDF e UMDF]
A estrutura WDF_REQUEST_PARAMETERS recebe parâmetros associados a uma solicitação de E/S.
Sintaxe
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;
Membros
Size
O tamanho, em bytes, dessa estrutura.
MinorFunction
O código de função secundária IRP, se houver, associado à solicitação de E/S. Alguns códigos de função principais associaram códigos de função secundárias.
Type
Um valor do tipo WDF_REQUEST_TYPE que identifica o tipo da solicitação de E/S.
Parameters
Parâmetros exclusivos para cada código de função principal do IRP. Esse membro contém um subconjunto do membro Parameters da estrutura IO_STACK_LOCATION .
Parameters.Create
Parâmetros para IRP_MJ_CREATE.
Parameters.Create.SecurityContext
Parameters.Create.Options
Parameters.Create.FileAttributes
Parameters.Create.ShareAccess
Parameters.Create.EaLength
Parameters.Read
Parâmetros para IRP_MJ_READ.
Parameters.Read.Length
Parameters.Read.Key
Parameters.Read.DeviceOffset
Parameters.Write
Parâmetros para IRP_MJ_WRITE.
Parameters.Write.Length
Parameters.Write.Key
Parameters.Write.DeviceOffset
Parameters.DeviceIoControl
Parâmetros para IRP_MJ_DEVICE_CONTROL e IRP_MJ_INTERNAL_DEVICE_CONTROL.
Parameters.DeviceIoControl.OutputBufferLength
Parameters.DeviceIoControl.InputBufferLength
Parameters.DeviceIoControl.IoControlCode
Parameters.DeviceIoControl.Type3InputBuffer
Parameters.Others
O uso desse membro é definido pela pilha de driver.
Parameters.Others.Arg1
Parameters.Others.Arg2
Parameters.Others.IoControlCode
Parameters.Others.Arg4
Comentários
A estrutura WDF_REQUEST_PARAMETERS é usada como entrada para WdfRequestGetParameters. Os drivers devem chamar WDF_REQUEST_PARAMETERS_INIT para inicializar essa estrutura antes de chamarem WdfRequestGetParameters.
Requisitos
| Requisito | Valor |
|---|---|
| Versão mínima do KMDF | 1.0 |
| Versão mínima do UMDF | 2,0 |
| Cabeçalho | wdfrequest.h (inclua Wdf.h) |