USBD_ParseConfigurationDescriptorEx (usbdlib.h)
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 |