fungsi WinUsb_QueryInterfaceSettings (winusb.h)

Artikel
08/27/2023

Fungsi WinUsb_QueryInterfaceSettings mengambil deskriptor antarmuka untuk pengaturan antarmuka alternatif yang ditentukan untuk handel antarmuka tertentu.

Sintaks

BOOL WinUsb_QueryInterfaceSettings(
  [in]  WINUSB_INTERFACE_HANDLE   InterfaceHandle,
  [in]  UCHAR                     AlternateInterfaceNumber,
  [out] PUSB_INTERFACE_DESCRIPTOR UsbAltInterfaceDescriptor
);

Parameter

[in] InterfaceHandle

Handel buram ke antarmuka dalam konfigurasi yang dipilih.

Untuk mengambil pengaturan antarmuka pertama, gunakan handel yang dikembalikan oleh WinUsb_Initialize. Untuk semua antarmuka lainnya, gunakan handel ke antarmuka target, yang diambil oleh WinUsb_GetAssociatedInterface.

[in] AlternateInterfaceNumber

Nilai yang menunjukkan pengaturan alternatif mana yang akan dikembalikan. Nilai 0 menunjukkan pengaturan alternatif pertama, nilai 1 menunjukkan pengaturan alternatif kedua, dan sebagainya.

[out] UsbAltInterfaceDescriptor

Penunjuk ke struktur USB_INTERFACE_DESCRIPTOR yang dialokasikan penelepon yang berisi informasi tentang antarmuka yang ditentukan AlternateSettingNumber .

Mengembalikan nilai

WinUsb_QueryInterfaceSettings mengembalikan TRUE jika operasi berhasil. Jika tidak, ia mengembalikan FALSE, dan pemanggil dapat mengambil kesalahan yang dicatat dengan memanggil GetLastError.

GetLastError dapat mengembalikan kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_HANDLE	Pemanggil melewati NULL dalam parameter InterfaceHandle .
ERROR_NO_MORE_ITEMS	Antarmuka alternatif yang ditentukan tidak ditemukan.

Keterangan

WinUsb_QueryInterfaceSettings mengurai deskriptor konfigurasi yang sebelumnya diambil oleh WinUsb_Initialize. Untuk informasi selengkapnya, lihat bagian Keterangan untuk WinUsb_Initialize.

Panggilan WinUsb_QueryInterfaceSettings mencari array antarmuka untuk antarmuka alternatif yang ditentukan oleh indeks antarmuka yang diteruskan oleh pemanggil di AlternateSettingNumber. Jika antarmuka yang ditentukan ditemukan, fungsi mengisi struktur USB_INTERFACE_DESCRIPTOR yang dialokasikan pemanggil. Jika antarmuka yang ditentukan tidak ditemukan, maka panggilan gagal dengan kode ERROR_NO_MORE_ITEMS.