USBD_ISINTERFACEVERSIONSUPPORTED 例程是由USB用戶端驅動程式呼叫,以檢查基礎USB驅動程式堆疊是否支援特定的USBD介面版本。
語法
BOOLEAN USBD_IsInterfaceVersionSupported(
[in] USBD_HANDLE USBDHandle,
[in] ULONG USBDInterfaceVersion
);
參數
[in] USBDHandle
用戶端驅動程式在先前呼叫 USBD_CreateHandle 例程時擷取的 USBD 句柄。
[in] USBDInterfaceVersion
LONG 值,表示要檢查 USB 驅動程式堆疊的 USBD 介面版本。 可能的值包括USBD_INTERFACE_VERSION_602或USBD_INTERFACE_VERSION_600。 如需詳細資訊,請參閱。
傳回值
如果USB驅動程式堆疊支援指定的USBD介面版本,USBD_IsInterfaceVersionSupported 會傳回TRUE;否則為 FALSE。 如需詳細資訊,請參閱。
言論
針對裝置載入的 USB 驅動程式堆疊取決於 Windows 版本、主機控制器硬體和 USB 裝置。 Windows 7 和舊版 Windows 支援USBD_INTERFACE_VERSION_600。 Windows 8 驅動程式堆疊支援的 USBD 介面版本USBD_INTERFACE_VERSION_602和USBD_INTERFACE_VERSION_600。 USB 用戶端驅動程式很少需要知道基礎驅動程式堆疊的介面版本。 如果需要這類資訊,客戶端驅動程式可以呼叫 USBD_IsInterfaceVersionSupported 例程,檢查基礎驅動程式堆疊是否支援特定介面版本。 例如,客戶端驅動程式會呼叫 USBD_IsInterfaceVersionSupported,以判斷驅動程式堆疊是否支援USBD_INTERFACE_VERSION_602。 如果支援該版本,例程會傳回 TRUE。
例程需要有效的 USBD 句柄(在先前呼叫 USBD_CreateHandle中取得)。 USBD_IsInterfaceVersionSupported 只能由以 Windows Vista 和更新版本的 Windows 為目標的用戶端驅動程式呼叫。 這些客戶端驅動程序必須取得 Windows 8 的 Windows 驅動程式套件 (WDK),才能成功呼叫例程。 USBD_IsInterfaceVersionSupported 會取代 USBD_GetUSBDIVersion 例程。
USBD 介面版本不會指出 USB 驅動程式堆疊所支援的功能。 例如,因為基礎驅動程式堆疊支援 USBD_INTERFACE_VERSION_602,客戶端驅動程式 不得 假設驅動程式可以使用靜態數據流功能。 這是因為,即使驅動程式堆疊支援此功能,主機控制器硬體或USB裝置可能不支援串流。 若要判斷 USB 驅動程式堆疊是否支援特定功能,請呼叫 USBD_QueryUsbCapability。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 需要適用於 Windows 8 的 WDK。 以 Windows Vista 和更新版本的 Windows作系統為目標。 |
目標平臺 | 桌面 |
標頭 | usbdlib.h |
連結庫 | Usbdex.lib |
IRQL | PASSIVE_LEVEL |