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

另請參閱

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