Compartilhar via


estrutura WDF_USB_PIPE_INFORMATION (wdfusb.h)

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

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)

Confira também

USBD_PIPE_INFORMATION

WDF_USB_PIPE_INFORMATION_INIT

WDF_USB_PIPE_TYPE

WdfUsbInterfaceGetConfiguredPipe

WdfUsbInterfaceGetEndpointInformation

WdfUsbTargetPipeGetInformation