USBD_IsInterfaceVersionSupported関数 (usbdlib.h)

USBD_IsInterfaceVersionSupported ルーチンは、基になる USB ドライバー スタックが特定の USBD インターフェイス バージョンをサポートしているかどうかをチェックするために、USB クライアント ドライバーによって呼び出されます。

構文

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

パラメーター

[in] USBDHandle

USBD_CreateHandle ルーチンの以前の呼び出しでクライアント ドライバーによって取得される USBD ハンドル。

[in] USBDInterfaceVersion

USB ドライバー スタックに対してチェックする USBD インターフェイスのバージョンを表す LONG 値。 使用可能な値には、USBD_INTERFACE_VERSION_602またはUSBD_INTERFACE_VERSION_600が含まれます。 詳細については、「解説」を参照してください。

戻り値

指定 した USBD インターフェイスのバージョンが USB ドライバー スタックでサポートされている場合、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 Driver Kit (WDK) を取得する必要があります。 USBD_IsInterfaceVersionSupportedは、USBD_GetUSBDIVersion ルーチンを置き換えます。

USBD インターフェイスのバージョンは、USB ドライバー スタックでサポートされている機能を示していません。 たとえば、基になるドライバー スタックがUSBD_INTERFACE_VERSION_602をサポートしているため、クライアント ドライバーは、ドライバーが静的ストリーム機能を使用できると想定 しないでください 。 これは、ドライバー スタックが機能をサポートしていても、ホスト コントローラー ハードウェアまたは USB デバイスがストリームをサポートしていない可能性があるためです。 USB ドライバー スタックが特定の機能をサポートしているかどうかを確認するには、 USBD_QueryUsbCapabilityを呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows 8には WDK が必要です。 Windows Vista 以降のバージョンの Windows オペレーティング システムを対象としています。
対象プラットフォーム	デスクトップ
Header	usbdlib.h
Library	Usbdex.lib
IRQL	PASSIVE_LEVEL