共用方式為


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

[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

另請參閱

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