USBD_ValidateConfigurationDescriptor函式 (usbdlib.h)
USBD_ValidateConfigurationDescriptor例程會驗證裝置傳回的所有描述項,以回應設定描述項要求。
語法
USBD_STATUS USBD_ValidateConfigurationDescriptor(
[in] PUSB_CONFIGURATION_DESCRIPTOR ConfigDesc,
[in] ULONG BufferLength,
[in] USHORT Level,
[out] PUCHAR *Offset,
[in, optional] ULONG Tag
);
參數
[in] ConfigDesc
組態描述項的指標,其中包含從USB裝置擷取的所有介面、連接點、廠商和類別特定描述項。
[in] BufferLength
正在驗證之組態描述元的大小,以位元組為單位。
[in] Level
要執行的驗證層級。 以下是有效值:
- 1-組態描述元標頭的基本驗證。
- 2-組態描述元的完整驗證,包括檢查無效的端點位址、介面編號、描述項結構、介面替代設定、介面數目,以及所有描述元的 bLength 字段。
- 3-除了層級 1 和 2 的驗證之外,層級 3 還會驗證加上驗證每個介面中的端點數目、強制執行 USB 規格的描述元 bLength 大小,並確認所有介面編號都是循序順序。
[out] Offset
設定描述符內的位移,其中驗證失敗。 只有在傳回USBD_STATUS_SUCCESS以外的狀態時,才有效。
[in, optional] Tag
配置記憶體時 ,USBD_ValidateConfigurationDescriptor 所使用的集區標籤。
傳回值
如果驗證失敗,USBD_STATUS_SUCCESS或適當的 USBD 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的作業系統中使用。 |
目標平台 | Universal |
標頭 | usbdlib.h (包含 Usbdlib.h) |
程式庫 | Usbd.lib |
IRQL | PASSIVE_LEVEL |