USBD_IsInterfaceVersionSupported Funktion (usbdlib.h)

Artikel
02/07/2025

Die USBD_IsInterfaceVersionSupported Routine wird von einem USB-Clienttreiber aufgerufen, um zu überprüfen, ob der zugrunde liegende USB-Treiberstapel eine bestimmte USBD-Schnittstellenversion unterstützt.

Syntax

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

Parameter

[in] USBDHandle

USBD-Handle, das vom Clienttreiber in einem vorherigen Aufruf der USBD_CreateHandle Routine abgerufen wird.

[in] USBDInterfaceVersion

Ein LONG-Wert, der die USBD-Schnittstellenversion darstellt, um den USB-Treiberstapel zu überprüfen. Mögliche Werte sind USBD_INTERFACE_VERSION_602 oder USBD_INTERFACE_VERSION_600. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

USBD_IsInterfaceVersionSupported gibt TRUE zurück, wenn die angegebene USBD-Schnittstellenversion vom USB-Treiberstapel unterstützt wird; Andernfalls FALSE. Weitere Informationen finden Sie in den Hinweisen.

Bemerkungen

Der für ein Gerät geladene USB-Treiberstapel hängt von der Windows-Version, der Hostcontrollerhardware und dem USB-Gerät ab. Windows 7 und frühere Versionen von Windows unterstützen USBD_INTERFACE_VERSION_600. Die vom Windows 8-Treiberstapel unterstützten USBD-Schnittstellenversionen werden USBD_INTERFACE_VERSION_602 und USBD_INTERFACE_VERSION_600. Ein USB-Clienttreiber muss selten über die Schnittstellenversion des zugrunde liegenden Treiberstapels wissen. In Fällen, in denen solche Informationen erforderlich sind, kann der Clienttreiber die USBD_IsInterfaceVersionSupported Routine aufrufen, um zu überprüfen, ob eine bestimmte Schnittstellenversion vom zugrunde liegenden Treiberstapel unterstützt wird. Beispielsweise ruft der Clienttreiber USBD_IsInterfaceVersionSupported auf, um festzustellen, ob der Treiberstapel USBD_INTERFACE_VERSION_602 unterstützt. Wenn sie diese Version unterstützt, gibt die Routine WAHR zurück.

Die Routine erfordert einen gültigen USBD-Handle (abgerufen in einem vorherigen Aufruf von USBD_CreateHandle). USBD_IsInterfaceVersionSupported können nur von Clienttreibern aufgerufen werden, die auf Windows Vista und höhere Versionen von Windows abzielen. Diese Clienttreiber müssen Windows Driver Kit (WDK) für Windows 8 abrufen, um die Routinen erfolgreich aufzurufen. USBD_IsInterfaceVersionSupported ersetzt die USBD_GetUSBDIVersion Routine.

Die USBD-Schnittstellenversion gibt nicht die vom USB-Treiberstapel unterstützten Funktionen an. Da beispielsweise der zugrunde liegende Treiberstapel USBD_INTERFACE_VERSION_602 unterstützt, darf der Clienttreiber nicht davon ausgehen, dass der Treiber die Statische Streams-Funktion verwenden kann. Das liegt daran, dass die Hostcontrollerhardware oder das USB-Gerät Datenströme möglicherweise nicht unterstützen, obwohl der Treiberstapel die Funktion unterstützt. Rufen Sie USBD_QueryUsbCapabilityauf, um zu ermitteln, ob der USB-Treiberstapel eine bestimmte Funktion unterstützt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Erfordert WDK für Windows 8. Zielt auf Windows Vista und höhere Versionen des Windows-Betriebssystems ab.
Zielplattform-	Desktop
Header-	usbdlib.h
Library	Usbdex.lib
IRQL-	PASSIVE_LEVEL

Freigeben über