structure WDF_USB_PIPE_INFORMATION (wdfusb.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

La structure WDF_USB_PIPE_INFORMATION contient des informations sur un canal USB et son point de terminaison.

Syntaxe

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;

Membres

Size

Taille, en octets, de cette structure.

MaximumPacketSize

Taille maximale des paquets, en octets, que le point de terminaison du canal est capable d’envoyer ou de recevoir.

Pour les points de terminaison isochrones à haute vitesse, la valeur MaximumPacketSize reçue inclut le nombre d’octets qui peuvent être transférés dans des transactions supplémentaires, si le point de terminaison les prend en charge.

EndpointAddress

Adresse du point de terminaison sur l’appareil USB. Pour plus d’informations sur les adresses de point de terminaison, consultez la spécification USB.

Interval

L’intervalle d’interrogation du point de terminaison, si le membre PipeType est défini sur WdfUsbPipeTypeInterrupt. Pour plus d’informations sur les intervalles d’interrogation, consultez la spécification USB.

SettingIndex

Valeur d’index qui identifie le paramètre de remplacement, dans une interface, auquel appartient le canal. Pour plus d’informations sur les autres paramètres, consultez la spécification USB.

PipeType

Valeur WDF_USB_PIPE_TYPE-typée qui spécifie le type de canal.

MaximumTransferSize

Ce membre n’est pas utilisé.

Remarques

La structure WDF_USB_PIPE_INFORMATION est remplie par le WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipeet méthodes WdfUsbInterfaceGetEndpointInformation.

Pour initialiser une structure WDF_USB_PIPE_INFORMATION, votre pilote doit appeler WDF_USB_PIPE_INFORMATION_INIT.

Pour plus d’informations sur le membre MaximumPacketSize de cette structure, consultez la section Notes de USBD_PIPE_INFORMATION.

Pour plus d’informations sur le transfert de données vers et depuis des points de terminaison isochronous pris en charge dans un appareil USB, consultez Comment transférer des données vers des points de terminaison isochronous USB.