WDF_USB_REQUEST_COMPLETION_PARAMS struttura (wdfusb.h)
[Si applica a KMDF e UMDF]
La struttura WDF_USB_REQUEST_COMPLETION_PARAMS contiene parametri associati al completamento di una richiesta di I/O per un dispositivo USB.
Sintassi
typedef struct _WDF_USB_REQUEST_COMPLETION_PARAMS {
USBD_STATUS UsbdStatus;
WDF_USB_REQUEST_TYPE Type;
union {
struct {
WDFMEMORY Buffer;
USHORT LangID;
UCHAR StringIndex;
UCHAR RequiredSize;
} DeviceString;
struct {
WDFMEMORY Buffer;
WDF_USB_CONTROL_SETUP_PACKET SetupPacket;
ULONG Length;
} DeviceControlTransfer;
struct {
WDFMEMORY Buffer;
} DeviceUrb;
struct {
WDFMEMORY Buffer;
size_t Length;
size_t Offset;
} PipeWrite;
struct {
WDFMEMORY Buffer;
size_t Length;
size_t Offset;
} PipeRead;
struct {
WDFMEMORY Buffer;
} PipeUrb;
} Parameters;
} WDF_USB_REQUEST_COMPLETION_PARAMS, *PWDF_USB_REQUEST_COMPLETION_PARAMS;
Members
UsbdStatus
Valore di stato USBD_STATUS tipizzato restituito dalla destinazione di I/O.
Type
Valori WDF_USB_REQUEST_TYPE tipizzati che identificano il tipo di richiesta.
Parameters
Parameters.DeviceString
Parameters.DeviceString.Buffer
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForString, questo membro contiene l'handle fornito dal driver all'oggetto memory che riceve la stringa Unicode.
Parameters.DeviceString.LangID
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForString, questo membro contiene l'identificatore del linguaggio fornito dal driver.
Parameters.DeviceString.StringIndex
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForString, questo membro contiene l'indice stringa fornito dal driver.
Parameters.DeviceString.RequiredSize
Se il driver ha chiamato qualsiasi metodo che ottiene le stringhe Unicode di un dispositivo ,ad eccezione di WdfUsbTargetDeviceFormatRequestForUrb, questo membro contiene le dimensioni necessarie del buffer specificato da Parameters.DeviceString.Buffer .
Se il driver denominato WdfUsbTargetDeviceFormatRequestForUrb, può ottenere il valore di dimensione richiesto dall'oggetto URB il cui handle è in Parameters.DeviceUrb.Buffer.
Parameters.DeviceControlTransfer
Parameters.DeviceControlTransfer.Buffer
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForControlTransfer, questo membro contiene l'handle fornito dal driver all'oggetto memory che riceve dati di input o output.
Parameters.DeviceControlTransfer.SetupPacket
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForControlTransfer, questo membro contiene l'indirizzo della struttura di WDF_USB_CONTROL_SETUP_PACKET fornita dal driver.
Parameters.DeviceControlTransfer.Length
Se il driver ha chiamato qualsiasi metodo che invia un trasferimento di controllo (ad eccezione di WdfUsbTargetDeviceFormatRequestForUrb), questo membro contiene il numero di byte inviati o ricevuti.
Se il driver denominato WdfUsbTargetDeviceFormatRequestForUrb, può ottenere il valore di lunghezza dall'ORDINAMENTO il cui handle è in Parameters.DeviceUrb.Buffer.
Parameters.DeviceUrb
Parameters.DeviceUrb.Buffer
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForUrb, questo membro contiene l'handle fornito dal driver all'oggetto memory che contiene una struttura URB .
Parameters.PipeWrite
Parameters.PipeWrite.Buffer
Se il driver ha chiamato WdfUsbTargetPipeFormatRequestForWrite, questo membro contiene l'handle fornito dal driver all'oggetto memoria scritto nella pipe.
Parameters.PipeWrite.Length
Se il driver ha chiamato qualsiasi metodo che scrive in una pipe (ad eccezione di WdfUsbTargetDeviceFormatRequestForUrb), questo membro contiene il numero di byte inviati.
Se il driver denominato WdfUsbTargetDeviceFormatRequestForUrb, può ottenere il valore di lunghezza dall'ORDINAMENTO il cui handle è in Parameters.PipeUrb.Buffer.
Parameters.PipeWrite.Offset
Se il driver ha chiamato WdfUsbTargetPipeFormatRequestForWrite, questo membro contiene l'offset del buffer fornito dal driver.
Parameters.PipeRead
Parameters.PipeRead.Buffer
Se il driver ha chiamato WdfUsbTargetPipeFormatRequestForRead, questo membro contiene l'handle fornito dal driver all'oggetto memoria che contiene dati letti dalla pipe.
Parameters.PipeRead.Length
Se il driver ha chiamato qualsiasi metodo che legge da una pipe invia un trasferimento di controllo (ad eccezione di WdfUsbTargetDeviceFormatRequestForUrb), questo membro contiene il numero di byte ricevuti.
Se il driver denominato WdfUsbTargetDeviceFormatRequestForUrb, può ottenere il valore di lunghezza dall'ORDINAMENTO il cui handle è in Parameters.PipeUrb.Buffer.
Parameters.PipeRead.Offset
Se il driver ha chiamato WdfUsbTargetPipeFormatRequestForRead, questo membro contiene l'offset del buffer fornito dal driver.
Parameters.PipeUrb
Parameters.PipeUrb.Buffer
Se il driver ha chiamato WdfUsbTargetPipeFormatRequestForUrb, questo membro contiene l'handle fornito dal driver all'oggetto memory che contiene una struttura URB .
Commenti
La struttura WDF_USB_REQUEST_COMPLETION_PARAMS è un membro della struttura WDF_REQUEST_COMPLETION_PARAMS .
Requisiti
| Requisito | Valore |
|---|---|
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfusb.h (include Wdfusb.h) |