struttura WDF_USB_REQUEST_COMPLETION_PARAMS (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;
Membri
UsbdStatus
Valore di stato USBD_STATUStipizzato restituito dalla destinazione di I/O.
Type
Valore WDF_USB_REQUEST_TYPEtipizzato che identifica 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 memoria che riceve la stringa Unicode.
Parameters.DeviceString.LangID
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForString, questo membro contiene l'identificatore di lingua 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 (tranne WdfUsbTargetDeviceFormatRequestForUrb), questo membro contiene le dimensioni necessarie del buffer specificato Parameters.DeviceString.Buffer.
Se il driver chiamato WdfUsbTargetDeviceFormatRequestForUrb, può ottenere il valore di dimensione richiesto dall'handle ODBC il cui handle si trova 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 memoria che riceve dati di input o output.
Parameters.DeviceControlTransfer.SetupPacket
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForControlTransfer, questo membro contiene l'indirizzo della struttura WDF_USB_CONTROL_SETUP_PACKET fornita dal driver.
Parameters.DeviceControlTransfer.Length
Se il driver ha chiamato qualsiasi metodo che invia un di trasferimento del controllo (tranne WdfUsbTargetDeviceFormatRequestForUrb), questo membro contiene il numero di byte inviati o ricevuti.
Se il driver chiamato WdfUsbTargetDeviceFormatRequestForUrb, può ottenere il valore di lunghezza dall'oggetto WSUS il cui handle si trova in Parameters.DeviceUrb.Buffer.
Parameters.DeviceUrb
Parameters.DeviceUrb.Buffer
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForUrb, questo membro contiene l'handle fornito dal driver per l'oggetto memoria che contiene una struttura .
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 un pipe (tranne WdfUsbTargetDeviceFormatRequestForUrb), questo membro contiene il numero di byte inviati.
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForUrb, può ottenere il valore di lunghezza dall'handle ODBC il cui handle si trova 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 i dati letti dalla pipe.
Parameters.PipeRead.Length
Se il driver ha chiamato qualsiasi metodo che legge da una pipe invia un trasferimento di controllo (tranne WdfUsbTargetDeviceFormatRequestForUrb), questo membro contiene il numero di byte ricevuti.
Se il driver ha chiamato WdfUsbTargetDeviceFormatRequestForUrb, può ottenere il valore di lunghezza dall'handle ODBC il cui handle si trova 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 memoria che contiene una struttura .
Osservazioni
La struttura WDF_USB_REQUEST_COMPLETION_PARAMS è un membro della struttura WDF_REQUEST_COMPLETION_PARAMS.
Fabbisogno
| Requisito | Valore |
|---|---|
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfusb.h (include Wdfusb.h) |