共用方式為

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

另請參閱

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