funzione USBD_IsInterfaceVersionSupported (usbdlib.h)

Articolo
02/07/2025

La routine USBD_IsInterfaceVersionSupported viene chiamata da un driver client USB per verificare se lo stack di driver USB sottostante supporta una particolare versione dell'interfaccia USBD.

Sintassi

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

Parametri

[in] USBDHandle

Handle USBD recuperato dal driver client in una chiamata precedente alla routine USBD_CreateHandle.

[in] USBDInterfaceVersion

Valore LONG che rappresenta la versione dell'interfaccia USBD da controllare sullo stack di driver USB. I valori possibili includono USBD_INTERFACE_VERSION_602 o USBD_INTERFACE_VERSION_600. Per altre informazioni, vedere Osservazioni.

Valore restituito

USBD_IsInterfaceVersionSupported restituisce TRUE se la versione dell'interfaccia USBD specificata è supportata dallo stack di driver USB; FALSE in caso contrario. Per altre informazioni, vedere Osservazioni.

Osservazioni

Lo stack di driver USB caricato per un dispositivo dipende dalla versione di Windows, dall'hardware del controller host e dal dispositivo USB. Windows 7 e versioni precedenti di Windows supportano USBD_INTERFACE_VERSION_600. Le versioni dell'interfaccia USBD, supportate dallo stack di driver di Windows 8, sono USBD_INTERFACE_VERSION_602 e USBD_INTERFACE_VERSION_600. Un driver client USB raramente deve conoscere la versione dell'interfaccia dello stack di driver sottostante. Nei casi in cui tali informazioni sono necessarie, il driver client può chiamare la routine USBD_IsInterfaceVersionSupported per verificare se una determinata versione dell'interfaccia è supportata dallo stack di driver sottostante. Ad esempio, il driver client chiama USBD_IsInterfaceVersionSupported per determinare se lo stack di driver supporta USBD_INTERFACE_VERSION_602. Se supporta tale versione, la routine restituisce TRUE.

La routine richiede un handle USBD valido (ottenuto in una chiamata precedente a USBD_CreateHandle). USBD_IsInterfaceVersionSupported può essere chiamato solo dai driver client destinati a Windows Vista e versioni successive di Windows. Questi driver client devono ottenere Windows Driver Kit (WDK) per Windows 8 per chiamare correttamente le routine. USBD_IsInterfaceVersionSupported sostituisce la routine USBD_GetUSBDIVersion.

La versione dell'interfaccia USBD non indica le funzionalità supportate dallo stack di driver USB. Ad esempio, solo perché lo stack di driver sottostante supporta USBD_INTERFACE_VERSION_602, il driver client non deve presupporre che il driver possa usare la funzionalità dei flussi statici. Ciò è dovuto al fatto che, anche se lo stack di driver supporta la funzionalità, l'hardware del controller host o il dispositivo USB potrebbe non supportare i flussi. Per determinare se lo stack di driver USB supporta una determinata funzionalità, chiamare USBD_QueryUsbCapability.

Fabbisogno

Requisito	Valore
client minimo supportato	Richiede WDK per Windows 8. È destinato a Windows Vista e versioni successive del sistema operativo Windows.
piattaforma di destinazione	Desktop
intestazione	usbdlib.h
libreria	Usbdex.lib
IRQL	PASSIVE_LEVEL

Condividi tramite