次の方法で共有

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 オペレーティング システムを対象としています。
ターゲット プラットフォーム の デスクトップ
ヘッダー usbdlib.h
ライブラリ Usbdex.lib
IRQL PASSIVE_LEVEL