estrutura WDF_USB_REQUEST_COMPLETION_PARAMS (wdfusb.h)
[Aplica-se a KMDF e UMDF]
A estrutura WDF_USB_REQUEST_COMPLETION_PARAMS contém parâmetros associados à conclusão de uma solicitação de E/S para um dispositivo USB.
Sintaxe
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;
Membros
UsbdStatus
O valor status tipo USBD_STATUS que o destino de E/S retornou.
Type
Um WDF_USB_REQUEST_TYPE valores tipado que identifica o tipo de solicitação.
Parameters
Parameters.DeviceString
Parameters.DeviceString.Buffer
Se o driver tiver chamado WdfUsbTargetDeviceFormatRequestForString, esse membro conterá o identificador fornecido pelo driver para o objeto de memória que recebe a cadeia de caracteres Unicode.
Parameters.DeviceString.LangID
Se o driver tiver chamado WdfUsbTargetDeviceFormatRequestForString, esse membro conterá o identificador de linguagem fornecido pelo driver.
Parameters.DeviceString.StringIndex
Se o driver tiver chamado WdfUsbTargetDeviceFormatRequestForString, esse membro conterá o índice de cadeia de caracteres fornecido pelo driver.
Parameters.DeviceString.RequiredSize
Se o driver tiver chamado qualquer método que obtenha as cadeias de caracteres Unicode de um dispositivo (exceto WdfUsbTargetDeviceFormatRequestForUrb), esse membro conterá o tamanho necessário do buffer especificado por Parameters.DeviceString.Buffer .
Se o driver chamado WdfUsbTargetDeviceFormatRequestForUrb, ele poderá obter o valor de tamanho necessário da URB cujo identificador está em Parameters.DeviceUrb.Buffer.
Parameters.DeviceControlTransfer
Parameters.DeviceControlTransfer.Buffer
Se o driver tiver chamado WdfUsbTargetDeviceFormatRequestForControlTransfer, esse membro conterá o identificador fornecido pelo driver para o objeto de memória que recebe dados de entrada ou saída.
Parameters.DeviceControlTransfer.SetupPacket
Se o driver tiver chamado WdfUsbTargetDeviceFormatRequestForControlTransfer, esse membro conterá o endereço da estrutura de WDF_USB_CONTROL_SETUP_PACKET fornecida pelo driver.
Parameters.DeviceControlTransfer.Length
Se o driver tiver chamado qualquer método que envia uma transferência de controle (exceto WdfUsbTargetDeviceFormatRequestForUrb), esse membro conterá o número de bytes que foram enviados ou recebidos.
Se o driver chamado WdfUsbTargetDeviceFormatRequestForUrb, ele poderá obter o valor de comprimento da URB cujo identificador está em Parameters.DeviceUrb.Buffer.
Parameters.DeviceUrb
Parameters.DeviceUrb.Buffer
Se o driver tiver chamado WdfUsbTargetDeviceFormatRequestForUrb, esse membro conterá o identificador fornecido pelo driver para o objeto de memória que contém uma estrutura URB .
Parameters.PipeWrite
Parameters.PipeWrite.Buffer
Se o driver tiver chamado WdfUsbTargetPipeFormatRequestForWrite, esse membro conterá o identificador fornecido pelo driver para o objeto de memória que foi gravado no pipe.
Parameters.PipeWrite.Length
Se o driver tiver chamado qualquer método que grave em um pipe (exceto WdfUsbTargetDeviceFormatRequestForUrb), esse membro conterá o número de bytes que foram enviados.
Se o driver chamado WdfUsbTargetDeviceFormatRequestForUrb, ele poderá obter o valor de comprimento do URB cujo identificador está em Parameters.PipeUrb.Buffer.
Parameters.PipeWrite.Offset
Se o driver tiver chamado WdfUsbTargetPipeFormatRequestForWrite, esse membro conterá o deslocamento de buffer fornecido pelo driver.
Parameters.PipeRead
Parameters.PipeRead.Buffer
Se o driver tiver chamado WdfUsbTargetPipeFormatRequestForRead, esse membro conterá o identificador fornecido pelo driver para o objeto de memória que contém dados que foram lidos do pipe.
Parameters.PipeRead.Length
Se o driver tiver chamado qualquer método que lê de um pipe enviar uma transferência de controle (exceto WdfUsbTargetDeviceFormatRequestForUrb), esse membro conterá o número de bytes recebidos.
Se o driver chamado WdfUsbTargetDeviceFormatRequestForUrb, ele poderá obter o valor de comprimento do URB cujo identificador está em Parameters.PipeUrb.Buffer.
Parameters.PipeRead.Offset
Se o driver tiver chamado WdfUsbTargetPipeFormatRequestForRead, esse membro conterá o deslocamento de buffer fornecido pelo driver.
Parameters.PipeUrb
Parameters.PipeUrb.Buffer
Se o driver tiver chamado WdfUsbTargetPipeFormatRequestForUrb, esse membro conterá o identificador fornecido pelo driver para o objeto de memória que contém uma estrutura URB .
Comentários
A estrutura WDF_USB_REQUEST_COMPLETION_PARAMS é membro da estrutura WDF_REQUEST_COMPLETION_PARAMS .
Requisitos
Requisito | Valor |
---|---|
Versão mínima do KMDF | 1.0 |
Versão mínima do UMDF | 2,0 |
Cabeçalho | wdfusb.h (include Wdfusb.h) |