USBD_ParseDescriptors函式 (usbdlib.h)
USBD_ParseDescriptors 例程會搜尋指定的組態描述元,並傳回符合搜尋準則之第一個描述元的指標。
語法
PUSB_COMMON_DESCRIPTOR USBD_ParseDescriptors(
[in] PVOID DescriptorBuffer,
[in] ULONG TotalLength,
[in] PVOID StartPosition,
[in] LONG DescriptorType
);
參數
[in] DescriptorBuffer
組態描述元的指標,其中包含要搜尋的描述項。
[in] TotalLength
指定 描述元Buffer 所指向之緩衝區的大小,以位元組為單位。
[in] StartPosition
組態描述元內的位址指標,提供於 描述元Buffer,以開始搜尋。 若要從組態描述元的開頭搜尋,參數 描述元Buffer,StartPosition 必須是相同的位址。
[in] DescriptorType
指定 USB 所指派的描述項類型代碼。 下列值適用於 USB 定義的描述元型態:
USB_STRING_DESCRIPTOR_TYPE
指定要搜尋的描述元是字串描述元。
USB_INTERFACE_DESCRIPTOR_TYPE
指定要搜尋的描述元是介面描述元。
USB_ENDPOINT_DESCRIPTOR_TYPE
指定要搜尋的描述元是端點描述元。
傳回值
USBD_ParseDescriptors 傳回 USB_COMMON_DESCRIPTOR 結構的指標,該結構是符合指定搜尋準則的第一個描述元的前端,如果找不到相符專案,則會傳回 NULL:
言論
此結構用來保存描述元的一部分,讓 USBD_ParseDescriptors 的呼叫者可以判斷用來存取描述元中剩餘數據的正確結構。 每個描述項類型在數據開頭都有這些字段,而呼叫者可以使用 bLengthbDescriptorType 成員來正確識別此描述元的類型。
當這個例程剖析尋找符合搜尋準則之描述元的組態描述元時,它會傳回第一個相符專案,終止搜尋。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | usbdlib.h (包括 Usbdlib.h) |
連結庫 | Usbd.lib |
IRQL | < DISPATCH_LEVEL |