USBD_ParseConfigurationDescriptorEx (usbdlib.h)

  • Artikel

USBD_ParseConfigurationDescriptorEx rutin mencari pendeskripsi konfigurasi tertentu dan mengembalikan penunjuk ke antarmuka yang cocok dengan kriteria pencarian yang diberikan.

Sintaks

PUSB_INTERFACE_DESCRIPTOR USBD_ParseConfigurationDescriptorEx(
  [in] PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  [in] PVOID                         StartPosition,
  [in] LONG                          InterfaceNumber,
  [in] LONG                          AlternateSetting,
  [in] LONG                          InterfaceClass,
  [in] LONG                          InterfaceSubClass,
  [in] LONG                          InterfaceProtocol
);

Parameter

[in] ConfigurationDescriptor

Arahkan ke deskriptor konfigurasi USB yang berisi antarmuka yang akan dicari.

[in] StartPosition

Arahkan ke alamat dalam pendeskripsi konfigurasi, yang disediakan di ConfigurationDescriptor, untuk mulai mencari. Untuk mencari dari awal deskriptor konfigurasi, parameter ConfigurationDescriptor dan StartPosition harus alamat yang sama.

[in] InterfaceNumber

Menentukan indeks antarmuka yang ditentukan perangkat yang akan diambil. Ini harus diatur ke -1 jika seharusnya bukan kriteria pencarian.

[in] AlternateSetting

Menentukan indeks pengaturan alternatif yang ditentukan perangkat dari antarmuka yang akan diambil. Jika pemanggil tidak ingin nilai pengaturan alternatif menjadi kriteria pencarian, parameter ini harus diatur ke -1.

[in] InterfaceClass

Menentukan pengidentifikasi yang ditentukan perangkat atau USB untuk kelas antarmuka antarmuka yang akan diambil. Jika pemanggil tidak ingin nilai kelas antarmuka menjadi kriteria pencarian, parameter ini harus diatur ke -1.

[in] InterfaceSubClass

Menentukan pengidentifikasi yang ditentukan perangkat atau USB untuk subkelas antarmuka antarmuka yang akan diambil. Jika pemanggil tidak ingin nilai subkelas antarmuka menjadi kriteria pencarian, parameter ini harus diatur ke -1.

[in] InterfaceProtocol

Menentukan pengidentifikasi yang ditentukan perangkat atau USB untuk protokol antarmuka antarmuka yang akan diambil. Jika pemanggil tidak ingin nilai protokol antarmuka menjadi kriteria pencarian, parameter ini harus diatur ke -1.

Nilai kembali

USBD_ParseConfigurationDescriptorEx mengembalikan penunjuk ke deskriptor antarmuka pertama yang cocok dengan kriteria pencarian yang diberikan. Jika tidak ada antarmuka yang cocok dengan kriteria pencarian, antarmuka akan mengembalikan NULL.

Keterangan

Penelepon dapat menentukan lebih dari salah satu kriteria pencarian (InterfaceNumber, AlternateSetting, InterfaceClass, InterfaceSubClass, dan InterfaceProtocol) saat menggunakan rutinitas ini untuk menemukan antarmuka dalam deskriptor konfigurasi. Misalnya kode, lihat USBD_CreateConfigurationRequestEx.

Ketika rutinitas ini mengurai deskriptor konfigurasi mencari deskriptor antarmuka yang cocok dengan kriteria pencarian, ia mengembalikan kecocokan pertama, mengakhiri pencarian. Penelepon harus menentukan kriteria pencarian sebanyak yang diperlukan untuk menemukan antarmuka yang diinginkan.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header usbdlib.h (termasuk Usbdlib.h)
Pustaka Usbd.lib
IRQL < DISPATCH_LEVEL

Lihat juga

Referensi pemrograman driver perangkat USB

USB_CONFIGURATION_DESCRIPTOR