fonction USBD_IsInterfaceVersionSupported (usbdlib.h)

Article
02/07/2025

La routine USBD_IsInterfaceVersionSupported est appelée par un pilote client USB pour vérifier 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 dans un appel précédent à la routine USBD_CreateHandle.

[in] USBDInterfaceVersion

Valeur LONG qui représente la version de l’interface USBD à vérifier sur la pile de pilotes USB. Les valeurs possibles incluent USBD_INTERFACE_VERSION_602 ou USBD_INTERFACE_VERSION_600. Pour plus d’informations, consultez Remarques.

Valeur de retour

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 Remarques.

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 de Windows 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 doit rarement connaître la version de l’interface de la pile de pilotes sous-jacente. Dans les cas où de telles informations sont requises, le pilote client peut appeler la routine USBD_IsInterfaceVersionSupported pour vérifier si une version d’interface particulière est prise en charge par la pile de pilotes sous-jacente. Par exemple, le pilote client appelle USBD_IsInterfaceVersionSupported pour déterminer si la pile des pilotes prend en charge USBD_INTERFACE_VERSION_602. Si elle prend en charge cette version, la routine retourne TRUE.

La routine nécessite une poignée USBD valide (obtenue dans 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 les routines avec succès. USBD_IsInterfaceVersionSupported remplace la routine de 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. Cela est dû au fait que, 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.

Exigences

Exigence	Valeur
client minimum 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	Bureau
d’en-tête	usbdlib.h
bibliothèque	Usbdex.lib
IRQL	PASSIVE_LEVEL

Partager via