WDF_USB_PIPE_INFORMATION structure (wdfusb.h)

Article
09/24/2022

[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 isochronous à haut débit, 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 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 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 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 Notes de USBD_PIPE_INFORMATION.

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