USBD_IsInterfaceVersionSupported, fonction (usbdlib.h)

  • Article

La routine USBD_IsInterfaceVersionSupported est appelée par un pilote client USB pour case activée si la pile de pilotes USB sous-jacente prend en charge une version d’interface USBD particulière.

Syntaxe

BOOLEAN USBD_IsInterfaceVersionSupported(
  [in] USBD_HANDLE USBDHandle,
  [in] ULONG       USBDInterfaceVersion
);

Paramètres

[in] USBDHandle

Handle USBD récupéré par le pilote client lors d’un appel précédent à la routine USBD_CreateHandle .

[in] USBDInterfaceVersion

Valeur LONG qui représente la version de l’interface USBD à case activée sur la pile de pilotes USB. Les valeurs possibles incluent USBD_INTERFACE_VERSION_602 ou USBD_INTERFACE_VERSION_600. Pour plus d'informations, consultez la section Notes.

Valeur retournée

USBD_IsInterfaceVersionSupported retourne TRUE si la version de l’interface USBD spécifiée est prise en charge par la pile de pilotes USB ; FALSE dans le cas contraire. Pour plus d'informations, consultez la section Notes.

Remarques

La pile de pilotes USB chargée pour un appareil dépend de la version de Windows, du matériel du contrôleur hôte et du périphérique USB. Windows 7 et versions antérieures prennent en charge USBD_INTERFACE_VERSION_600. Les versions de l’interface USBD, prises en charge par la pile de pilotes Windows 8, sont USBD_INTERFACE_VERSION_602 et USBD_INTERFACE_VERSION_600. Un pilote client USB a rarement besoin de connaître la version de l’interface de la pile de pilotes sous-jacente. Dans les cas où ces informations sont requises, le pilote client peut appeler la routine USBD_IsInterfaceVersionSupported pour case activée si une version d’interface particulière est prise en charge par la pile de pilotes sous-jacente. Par instance, le pilote client appelle USBD_IsInterfaceVersionSupported pour déterminer si la pile de pilotes prend en charge USBD_INTERFACE_VERSION_602. Si elle prend en charge cette version, la routine retourne TRUE.

La routine nécessite un handle USBD valide (obtenu lors d’un appel précédent à USBD_CreateHandle). USBD_IsInterfaceVersionSupported ne peut être appelé que par les pilotes clients qui ciblent Windows Vista et les versions ultérieures de Windows. Ces pilotes clients doivent obtenir le Kit de pilotes Windows (WDK) pour Windows 8 afin d’appeler correctement les routines. USBD_IsInterfaceVersionSupported remplace la routine USBD_GetUSBDIVersion .

La version de l’interface USBD n’indique pas les fonctionnalités prises en charge par la pile de pilotes USB. Par exemple, simplement parce que la pile de pilotes sous-jacente prend en charge USBD_INTERFACE_VERSION_602, le pilote client ne doit pas supposer que le pilote peut utiliser la fonctionnalité de flux statiques. En effet, même si la pile de pilotes prend en charge la fonctionnalité, le matériel du contrôleur hôte ou le périphérique USB peut ne pas prendre en charge les flux. Pour déterminer si la pile de pilotes USB prend en charge une certaine fonctionnalité, appelez USBD_QueryUsbCapability.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Nécessite WDK pour Windows 8. Cible Windows Vista et les versions ultérieures du système d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête usbdlib.h
Bibliothèque Usbdex.lib
IRQL PASSIVE_LEVEL