WDF_REQUEST_PARAMETERS-Struktur (wdfrequest.h)
[Gilt für KMDF und UMDF]
Die WDF_REQUEST_PARAMETERS-Struktur empfängt Parameter, die einer E/A-Anforderung zugeordnet sind.
Syntax
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;
Member
Size
Die Größe (in Bytes) dieser Struktur.
MinorFunction
Der IRP-Nebenfunktionscode, falls vorhanden, der der E/A-Anforderung zugeordnet ist. Einige Hauptfunktionscodes verfügen über zugeordnete Nebenfunktionscodes.
Type
Ein WDF_REQUEST_TYPE typisierter Wert, der den Typ der E/A-Anforderung identifiziert.
Parameters
Parameter, die für jeden IRP-Hauptfunktionscode eindeutig sind. Dieses Element enthält eine Teilmenge des Parameters-Elements der IO_STACK_LOCATION-Struktur .
Parameters.Create
Parameter für IRP_MJ_CREATE.
Parameters.Create.SecurityContext
Parameters.Create.Options
Parameters.Create.FileAttributes
Parameters.Create.ShareAccess
Parameters.Create.EaLength
Parameters.Read
Parameter für IRP_MJ_READ.
Parameters.Read.Length
Parameters.Read.Key
Parameters.Read.DeviceOffset
Parameters.Write
Parameter für IRP_MJ_WRITE.
Parameters.Write.Length
Parameters.Write.Key
Parameters.Write.DeviceOffset
Parameters.DeviceIoControl
Parameter für IRP_MJ_DEVICE_CONTROL und IRP_MJ_INTERNAL_DEVICE_CONTROL.
Parameters.DeviceIoControl.OutputBufferLength
Parameters.DeviceIoControl.InputBufferLength
Parameters.DeviceIoControl.IoControlCode
Parameters.DeviceIoControl.Type3InputBuffer
Parameters.Others
Die Verwendung dieses Members wird durch den Treiberstapel definiert.
Parameters.Others.Arg1
Parameters.Others.Arg2
Parameters.Others.IoControlCode
Parameters.Others.Arg4
Hinweise
Die WDF_REQUEST_PARAMETERS-Struktur wird als Eingabe für WdfRequestGetParameters verwendet. Treiber müssen WDF_REQUEST_PARAMETERS_INIT aufrufen, um diese Struktur zu initialisieren, bevor sie WdfRequestGetParameters aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfrequest.h (include Wdf.h) |