estrutura WDF_USB_PIPE_INFORMATION (wdfusb.h)

Artigo
08/08/2023

[Aplica-se a KMDF e UMDF]

A estrutura WDF_USB_PIPE_INFORMATION contém informações sobre um pipe USB e seu ponto de extremidade.

Sintaxe

typedef struct _WDF_USB_PIPE_INFORMATION {
  ULONG             Size;
  ULONG             MaximumPacketSize;
  UCHAR             EndpointAddress;
  UCHAR             Interval;
  UCHAR             SettingIndex;
  WDF_USB_PIPE_TYPE PipeType;
  ULONG             MaximumTransferSize;
} WDF_USB_PIPE_INFORMATION, *PWDF_USB_PIPE_INFORMATION;

Membros

Size

O tamanho, em bytes, dessa estrutura.

MaximumPacketSize

O tamanho máximo do pacote, em bytes, que o ponto de extremidade do pipe é capaz de enviar ou receber.

Para pontos de extremidade isócronos de alta velocidade, o valor MaximumPacketSize recebido inclui o número de bytes que podem ser transferidos em transações adicionais, se o ponto de extremidade der suporte a eles.

EndpointAddress

O endereço do ponto de extremidade no dispositivo USB. Para obter mais informações sobre endereços de ponto de extremidade, consulte a especificação USB.

Interval

O intervalo de sondagem do ponto de extremidade, se o membro PipeType estiver definido como WdfUsbPipeTypeInterrupt. Para obter mais informações sobre intervalos de sondagem, consulte a especificação USB.

SettingIndex

Um valor de índice que identifica a configuração alternativa, dentro de uma interface à qual o pipe pertence. Para obter mais informações sobre configurações alternativas, consulte a especificação USB.

PipeType

Um valor do tipo WDF_USB_PIPE_TYPE que especifica o tipo de pipe.

MaximumTransferSize

Este membro não é usado.

Comentários

A estrutura WDF_USB_PIPE_INFORMATION é preenchida pelos métodos WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipe e WdfUsbInterfaceGetEndpointInformation .

Para inicializar uma estrutura de WDF_USB_PIPE_INFORMATION , o driver deve chamar WDF_USB_PIPE_INFORMATION_INIT.

Para obter mais informações sobre o membro MaximumPacketSize dessa estrutura, consulte a seção Comentários do USBD_PIPE_INFORMATION.

Para obter informações sobre como transferir dados de e para pontos de extremidade isócronos com suporte em um dispositivo USB, consulte Como transferir dados para pontos de extremidade isócronos USB.