estrutura WDF_USB_REQUEST_COMPLETION_PARAMS (wdfusb.h)

Artigo
08/08/2023

[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 .