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
指定 DescriptorBuffer 所指向緩衝區的大小,以位元組為單位。
[in] StartPosition
設定描述元內位址的指標,在 DescriptorBuffer 中提供,以開始搜尋。 若要從組態描述元的開頭搜尋,參數 DescriptorBuffer 和 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 呼叫者可以判斷用來存取描述元中剩餘數據的正確結構。 每個描述項類型在數據開頭都有這些字段,而呼叫端可以使用 bLength 和 bDescriptorType 成員正確地識別此描述元的類型。
當這個例程剖析組態描述元,尋找符合搜尋準則的描述元時,它會傳回第一個相符專案,結束搜尋。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | usbdlib.h (包含 Usbdlib.h) |
程式庫 | Usbd.lib |
IRQL | < DISPATCH_LEVEL |