共用方式為


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 中提供,以開始搜尋。 若要從組態描述元的開頭搜尋,參數 DescriptorBufferStartPosition 必須是相同的位址。

[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 成員正確地識別此描述元的類型。

當這個例程剖析組態描述元,尋找符合搜尋準則的描述元時,它會傳回第一個相符專案,結束搜尋。

規格需求

需求
目標平台 Universal
標頭 usbdlib.h (包含 Usbdlib.h)
程式庫 Usbd.lib
IRQL < DISPATCH_LEVEL

另請參閱

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