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 |