共用方式為


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

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

要求

要求 價值
目標平臺 普遍
標頭 usbdlib.h (包括 Usbdlib.h)
連結庫 Usbd.lib
IRQL < DISPATCH_LEVEL

另請參閱

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

USB_CONFIGURATION_DESCRIPTOR