WDF_REQUEST_COMPLETION_PARAMS struttura (wdfrequest.h)

Articolo
08/08/2023

[Si applica a KMDF e UMDF]

La struttura WDF_REQUEST_COMPLETION_PARAMS contiene parametri associati al completamento di una richiesta di I/O.

Sintassi

typedef struct _WDF_REQUEST_COMPLETION_PARAMS {
  ULONG            Size;
  WDF_REQUEST_TYPE Type;
  IO_STATUS_BLOCK  IoStatus;
  union {
    struct {
      WDFMEMORY Buffer;
      size_t    Length;
      size_t    Offset;
    } Write;
    struct {
      WDFMEMORY Buffer;
      size_t    Length;
      size_t    Offset;
    } Read;
    struct {
      ULONG  IoControlCode;
      struct {
        WDFMEMORY Buffer;
        size_t    Offset;
      } Input;
      struct {
        WDFMEMORY Buffer;
        size_t    Offset;
        size_t    Length;
      } Output;
    } Ioctl;
    struct {
      union {
        PVOID     Ptr;
        ULONG_PTR Value;
      } Argument1;
      union {
        PVOID     Ptr;
        ULONG_PTR Value;
      } Argument2;
      union {
        PVOID     Ptr;
        ULONG_PTR Value;
      } Argument3;
      union {
        PVOID     Ptr;
        ULONG_PTR Value;
      } Argument4;
    } Others;
    struct {
      PWDF_USB_REQUEST_COMPLETION_PARAMS Completion;
    } Usb;
  } Parameters;
} WDF_REQUEST_COMPLETION_PARAMS, *PWDF_REQUEST_COMPLETION_PARAMS;

Members

Size

Dimensione, in byte, della struttura.

Type

Valore WDF_REQUEST_TYPE che identifica il tipo di richiesta.

IoStatus

Struttura IO_STATUS_BLOCK per la richiesta.

Parameters

Valori specifici della richiesta.

Parameters.Write

Parameters.Write.Buffer

Handle per un oggetto memoria framework. Questo oggetto identifica il buffer specificato dal driver quando ha formattato la richiesta e l'ha inviata a una destinazione di I/O.

Parameters.Write.Length

Lunghezza, in byte, del trasferimento.

Parameters.Write.Offset

Indirizzo iniziale all'interno del buffer per il trasferimento dei dati.

Parameters.Read

Parameters.Read.Buffer

Handle per un oggetto memoria framework. Questo oggetto identifica il buffer specificato dal driver quando ha formattato la richiesta e l'ha inviata a una destinazione di I/O.

Parameters.Read.Length

Lunghezza, in byte, del trasferimento.

Parameters.Read.Offset

Indirizzo iniziale all'interno del buffer per il trasferimento dei dati.

Parameters.Ioctl

Parameters.Ioctl.IoControlCode

Parameters.Ioctl.Input

Parameters.Ioctl.Input.Buffer

Handle per un oggetto memoria framework. Questo oggetto identifica il buffer di input specificato dal driver quando ha formattato la richiesta e l'ha inviata a una destinazione di I/O.

Parameters.Ioctl.Input.Offset

Indirizzo iniziale all'interno del buffer per il trasferimento dei dati.

Parameters.Ioctl.Output

Parameters.Ioctl.Output.Buffer

Handle per un oggetto memoria framework. Questo oggetto identifica i buffer di output specificati dal driver quando ha formattato la richiesta e l'ha inviata a una destinazione di I/O.

Parameters.Ioctl.Output.Offset

Indirizzo iniziale all'interno del buffer per il trasferimento dei dati.

Parameters.Ioctl.Output.Length

Lunghezza, in byte, del trasferimento.

Parameters.Others

Parameters.Others.Argument1

L'uso di questo membro è definito dallo stack di driver. Vedere la sezione Osservazioni.

Parameters.Others.Argument1.Ptr

Parameters.Others.Argument1.Value

Parameters.Others.Argument2

L'uso di questo membro è definito dallo stack di driver.

Parameters.Others.Argument2.Ptr

Parameters.Others.Argument2.Value

Parameters.Others.Argument3

L'uso di questo membro è definito dallo stack di driver.

Parameters.Others.Argument3.Ptr

Parameters.Others.Argument3.Value

Parameters.Others.Argument4

L'uso di questo membro è definito dallo stack di driver.

Parameters.Others.Argument4.Ptr

Parameters.Others.Argument4.Value

Parameters.Usb

Per i dispositivi USB, questo membro contiene un puntatore a una struttura WDF_USB_REQUEST_COMPLETION_PARAMS .

Parameters.Usb.Completion

Commenti

La struttura WDF_REQUEST_COMPLETION_PARAMS viene usata come input per il metodo WdfRequestGetCompletionParams e la funzione di callback Di completamento di un driver.

In entrambi i casi, la struttura dei parametri di completamento contiene informazioni valide solo se il driver ha formattato la richiesta chiamando uno dei metodi WdfIoTargetFormatXxx . Ad esempio, vedere WdfIoTargetFormatRequestForRead.

Prima di chiamare WdfRequestGetCompletionParams per recuperare le informazioni di completamento di I/O per una richiesta, il driver deve prima chiamare WDF_REQUEST_COMPLETION_PARAMS_INIT per inizializzare la struttura WDF_REQUEST_COMPLETION_PARAMS .

I membri Parameters.Others.Argument sono argomenti personalizzati che un driver in genere passa lo stack e può tornare dopo il completamento della richiesta. Vengono usati per dati dipendenti dallo stack di driver non standard. Ad esempio, un driver USB specifica un puntatore a un PUNTATORE in Parameters.Others.Argument1 quando invia una richiesta di IOCTL_INTERNAL_USB_SUBMIT_URB allo stack USB. Analogamente, un driver Bluetooth specifica un puntatore a un blocco richiesta BRB (Bluetooth Request Block) in Parameters.Others.Argument1 quando riceve un IOCTL_INTERNAL_BTH_SUBMIT_BRB.