USBD_IsInterfaceVersionSupported-Funktion (usbdlib.h)

  • Artikel

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, die mit dem USB-Treiberstapel überprüft werden soll. 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. False andernfalls. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

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 sind USBD_INTERFACE_VERSION_602 und USBD_INTERFACE_VERSION_600. Ein USB-Clienttreiber muss selten etwas ü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. Für instance ruft der Clienttreiber USBD_IsInterfaceVersionSupported auf, um zu bestimmen, ob der Treiberstapel USBD_INTERFACE_VERSION_602 unterstützt. Wenn diese Version unterstützt wird, gibt die Routine TRUE zurück.

Die Routine erfordert ein gültiges 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 erhalten, um die Routinen erfolgreich aufrufen zu können. USBD_IsInterfaceVersionSupported ersetzt die USBD_GetUSBDIVersion Routine.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Erfordert WDK für Windows 8. Zielt auf Windows Vista und höhere Versionen des Windows-Betriebssystems ab.
Zielplattform Desktop
Kopfzeile usbdlib.h
Bibliothek Usbdex.lib
IRQL PASSIVE_LEVEL