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。

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

規格需求

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

另請參閱

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

USB_CONFIGURATION_DESCRIPTOR