USBD_ParseConfigurationDescriptorEx関数 (usbdlib.h)

  • [アーティクル]

USBD_ParseConfigurationDescriptorEx ルーチンは、特定の構成記述子を検索し、指定された検索条件に一致するインターフェイスへのポインターを返します。

構文

PUSB_INTERFACE_DESCRIPTOR USBD_ParseConfigurationDescriptorEx(
  [in] PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  [in] PVOID                         StartPosition,
  [in] LONG                          InterfaceNumber,
  [in] LONG                          AlternateSetting,
  [in] LONG                          InterfaceClass,
  [in] LONG                          InterfaceSubClass,
  [in] LONG                          InterfaceProtocol
);

パラメーター

[in] ConfigurationDescriptor

検索対象のインターフェイスを含む USB 構成記述子へのポインター。

[in] StartPosition

ConfigurationDescriptor で提供される構成記述子内のアドレスへのポインター。検索を開始します。 構成記述子の先頭から検索するには、 パラメーター ConfigurationDescriptor と StartPosition が同じアドレスである必要があります。

[in] InterfaceNumber

取得するインターフェイスのデバイス定義インデックスを指定します。 検索条件にしない場合は、-1 に設定する必要があります。

[in] AlternateSetting

取得するインターフェイスのデバイス定義の代替設定インデックスを指定します。 呼び出し元が代替設定値を検索条件にしたくない場合は、このパラメーターを -1 に設定する必要があります。

[in] InterfaceClass

取得するインターフェイスのインターフェイス クラスのデバイスまたは USB で定義された識別子を指定します。 呼び出し元がインターフェイス クラスの値を検索条件にしたくない場合は、このパラメーターを -1 に設定する必要があります。

[in] InterfaceSubClass

取得するインターフェイスのインターフェイス サブクラスのデバイスまたは USB で定義された識別子を指定します。 呼び出し元がインターフェイス サブクラス値を検索条件にしたくない場合は、このパラメーターを -1 に設定する必要があります。

[in] InterfaceProtocol

取得するインターフェイスのインターフェイス プロトコルのデバイスまたは USB で定義された識別子を指定します。 呼び出し元がインターフェイス プロトコル値を検索条件にしたくない場合は、このパラメーターを -1 に設定する必要があります。

戻り値

USBD_ParseConfigurationDescriptorEx は、指定された検索条件に一致する最初のインターフェイス記述子へのポインターを返します。 検索条件に一致するインターフェイスがない場合は、 NULL を返します。

注釈

呼び出し元は、このルーチンを使用して構成記述子内のインターフェイスを検索するときに、複数の検索条件 (InterfaceNumber、AlternateSetting、InterfaceClass、InterfaceSubClass、および InterfaceProtocol) を指定できます。 コード例については、「 USBD_CreateConfigurationRequestEx」を参照してください。

このルーチンは、検索条件に一致するインターフェイス記述子を探して構成記述子を解析すると、最初の一致を返し、検索を終了します。 呼び出し元は、必要なインターフェイスを見つけるために必要な数の検索条件を指定する必要があります。

要件

要件 値
対象プラットフォーム ユニバーサル
Header usbdlib.h (Usbdlib.h を含む)
Library Usbd.lib
IRQL < DISPATCH_LEVEL

こちらもご覧ください

USB デバイス ドライバーのプログラミング参照

USB_CONFIGURATION_DESCRIPTOR