USBD_IsInterfaceVersionSupported函式 (usbdlib.h)

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_CreateHandle ) 取得的有效 USBD 句柄 (。 USBD_IsInterfaceVersionSupported 只能由以 Windows Vista 和更新版本的 Windows 為目標的用戶端驅動程式呼叫。 這些客戶端驅動程序必須取得 Windows 驅動程式套件 (WDK) Windows 8，才能成功呼叫例程。 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