USBD_ValidateConfigurationDescriptor (usbdlib.h)

  • Artikel

USBD_ValidateConfigurationDescriptor rutin memvalidasi semua deskriptor yang dikembalikan oleh perangkat sebagai responsnya terhadap permintaan deskriptor konfigurasi.

Sintaks

USBD_STATUS USBD_ValidateConfigurationDescriptor(
  [in]           PUSB_CONFIGURATION_DESCRIPTOR ConfigDesc,
  [in]           ULONG                         BufferLength,
  [in]           USHORT                        Level,
  [out]          PUCHAR                        *Offset,
  [in, optional] ULONG                         Tag
);

Parameter

[in] ConfigDesc

Penunjuk ke deskriptor konfigurasi yang mencakup semua antarmuka, titik akhir, vendor, dan deskriptor khusus kelas yang diambil dari perangkat USB.

[in] BufferLength

Ukuran, dalam byte, dari deskriptor konfigurasi yang sedang divalidasi.

[in] Level

Tingkat validasi yang akan dilakukan. Berikut ini adalah nilai yang valid:

  • Validasi 1-Dasar header deskriptor konfigurasi.
  • Validasi 2-Penuh dari deskriptor konfigurasi termasuk memeriksa alamat titik akhir yang tidak valid, nomor antarmuka, struktur deskriptor, pengaturan alternatif antarmuka, jumlah antarmuka dan bidang bLength dari semua deskriptor.
  • 3-Selain validasi untuk tingkat 1 dan 2, tingkat 3 memvalidasi ditambah memvalidasi jumlah titik akhir di setiap antarmuka, memberlakukan ukuran bLength deskriptor spesifikasi USB, dan memverifikasi bahwa semua nomor antarmuka berada dalam urutan berurutan.

[out] Offset

Offset dalam pendeskripsi konfigurasi di mana validasi gagal. Hanya valid ketika status selain USBD_STATUS_SUCCESS dikembalikan.

[in, optional] Tag

Tag kumpulan yang digunakan oleh USBD_ValidateConfigurationDescriptor saat mengalokasikan memori.

Nilai kembali

USBD_STATUS_SUCCESS, atau kode kesalahan USBD yang sesuai jika validasi gagal.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Vista dan sistem operasi yang lebih baru.
Target Platform Universal
Header usbdlib.h (termasuk Usbdlib.h)
Pustaka Usbd.lib
IRQL PASSIVE_LEVEL

Lihat juga

Referensi pemrograman driver perangkat USB