fungsi WinUsb_SetCurrentAlternateSetting (winusb.h)

Fungsi WinUsb_SetCurrentAlternateSetting mengatur pengaturan alternatif antarmuka.

Sintaks

BOOL WinUsb_SetCurrentAlternateSetting(
  [in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in] UCHAR                   SettingNumber
);

Parameter

[in] InterfaceHandle

Handel buram ke antarmuka, yang menentukan pengaturan alternatif yang akan diatur.

Untuk mengatur pengaturan alternatif di antarmuka pertama pada perangkat, gunakan handel antarmuka yang dikembalikan oleh WinUsb_Initialize. Untuk semua antarmuka lainnya, gunakan handel ke antarmuka target, yang diambil oleh WinUsb_GetAssociatedInterface.

[in] SettingNumber

Nilai yang terkandung dalam anggota bAlternateSetting dari struktur USB_INTERFACE_DESCRIPTOR . Struktur ini diisi oleh rutinitas WinUsb_QueryInterfaceSettings .

Menampilkan nilai

WinUsb_SetCurrentAlternateSetting mengembalikan TRUE jika operasi berhasil. Jika tidak, fungsi ini 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 .

Keterangan

WinUsb_SetCurrentAlternateSetting gagal jika permintaan I/O yang luar biasa ada di antarmuka.

Persyaratan

Target Platform	Universal
Header	winusb.h (termasuk Winusb.h)
Pustaka	Winusb.lib
DLL	Winusb.dll

Lihat juga

USB_INTERFACE_DESCRIPTOR

WinUSB

Fungsi WinUSB

WinUsb_Initialize

WinUsb_QueryInterfaceSettings