WDF_USB_PIPE_INFORMATION structure (wdfusb.h)

Article
03/01/2024

[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 peut envoyer ou recevoir.

Pour les points de terminaison isochrone haute vitesse, la valeur MaximumPacketSize reçue inclut le nombre d’octets pouvant ê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 le périphérique USB. Pour plus d’informations sur les adresses de point de terminaison, consultez la spécification USB.

Interval

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 l’autre paramètre, au sein d’une interface, auquel appartient le canal. Pour plus d’informations sur les autres paramètres, consultez la spécification USB.

PipeType

Valeur de type WDF_USB_PIPE_TYPE qui spécifie le type de canal.

MaximumTransferSize

Ce membre n’est pas utilisé.

Remarques

La structure WDF_USB_PIPE_INFORMATION est remplie par les méthodes WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipe et 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 Remarques de USBD_PIPE_INFORMATION.

Pour plus d’informations sur la façon de transférer des données vers et depuis des points de terminaison isochroques pris en charge dans un périphérique USB, consultez Comment transférer des données vers des points de terminaison isochrones USB.