共用方式為


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 提供的組態描述元中,開始搜尋之位址的指標。 若要從組態描述元的開頭搜尋, ConfigurationDescriptorStartPosition 參數必須是相同的位址。

[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

當這個例程剖析組態描述元,尋找符合搜尋準則的介面描述元時,它會傳回第一個相符專案,結束搜尋。 呼叫端應該指定所需的搜尋準則數目,以尋找所需的介面。

規格需求

需求
目標平台 Universal
標頭 usbdlib.h (包含 Usbdlib.h)
程式庫 Usbd.lib
IRQL < DISPATCH_LEVEL

另請參閱

USB 設備驅動器程式設計參考

USB_CONFIGURATION_DESCRIPTOR