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 |