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 |