struttura WDF_USB_PIPE_INFORMATION (wdfusb.h)

Articolo
02/27/2024

[Si applica a KMDF e UMDF]

La struttura WDF_USB_PIPE_INFORMATION contiene informazioni su una pipe USB e il relativo endpoint.

Sintassi

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;

Members

Size

Dimensione, in byte, della struttura.

MaximumPacketSize

Dimensioni massime dei pacchetti, in byte, che l'endpoint della pipe è in grado di inviare o ricevere.

Per gli endpoint isocroni ad alta velocità, il valore MaximumPacketSize ricevuto include il numero di byte che possono essere trasferiti in transazioni aggiuntive, se l'endpoint le supporta.

EndpointAddress

Indirizzo dell'endpoint nel dispositivo USB. Per altre informazioni sugli indirizzi endpoint, vedere la specifica USB.

Interval

Intervallo di polling dell'endpoint, se il membro PipeType è impostato su WdfUsbPipeTypeInterrupt. Per altre informazioni sugli intervalli di polling, vedere la specifica USB.

SettingIndex

Valore di indice che identifica l'impostazione alternativa, all'interno di un'interfaccia, a cui appartiene la pipe. Per altre informazioni sulle impostazioni alternative, vedere la specifica USB.

PipeType

Valore tipizzato WDF_USB_PIPE_TYPE che specifica il tipo di pipe.

MaximumTransferSize

Questo membro non viene utilizzato.

Commenti

La struttura WDF_USB_PIPE_INFORMATION viene compilata dai metodi WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipe e WdfUsbInterfaceGetEndpointInformation .

Per inizializzare una struttura di WDF_USB_PIPE_INFORMATION , il driver deve chiamare WDF_USB_PIPE_INFORMATION_INIT.

Per altre informazioni sul membro MaximumPacketSize di questa struttura, vedere la sezione Osservazioni di USBD_PIPE_INFORMATION.

Per informazioni su come trasferire dati da e verso endpoint isocroni supportati in un dispositivo USB, vedere Come trasferire dati a endpoint isocroni USB.