funzione USBD_IsInterfaceVersionSupported (usbdlib.h)

Articolo
08/07/2023

La routine USBD_IsInterfaceVersionSupported viene chiamata da un driver client USB per verificare se lo stack di driver USB sottostante supporta una determinata 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 di 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 la sezione 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 la sezione Osservazioni.

Commenti

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 del supporto di Windows USBD_INTERFACE_VERSION_600. Le versioni dell'interfaccia USBD supportate dallo stack di driver 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, poiché 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. Questo perché, 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.

Requisiti

Requisito	Valore
Client minimo supportato	Richiede WDK per Windows 8. Destinazione Windows Vista e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Desktop
Intestazione	usbdlib.h
Libreria	Usbdex.lib
IRQL	PASSIVE_LEVEL

Condividi tramite