fungsi WinUsb_GetAssociatedInterface (winusb.h)

Artikel
03/13/2024

Fungsi WinUsb_GetAssociatedInterface mengambil handel untuk antarmuka terkait. Ini adalah operasi sinkron.

Sintaks

BOOL WinUsb_GetAssociatedInterface(
  [in]  WINUSB_INTERFACE_HANDLE  InterfaceHandle,
  [in]  UCHAR                    AssociatedInterfaceIndex,
  [out] PWINUSB_INTERFACE_HANDLE AssociatedInterfaceHandle
);

Parameter

[in] InterfaceHandle

Handel buram ke antarmuka pertama (default) pada perangkat, yang dikembalikan oleh WinUsb_Initialize.

[in] AssociatedInterfaceIndex

Indeks yang menentukan antarmuka terkait untuk diambil. Nilai 0 menunjukkan antarmuka terkait pertama, nilai 1 menunjukkan antarmuka terkait kedua, dan sebagainya.

[out] AssociatedInterfaceHandle

Handel untuk antarmuka terkait. Penelepon harus meneruskan handel antarmuka ini ke Fungsi WinUSB yang diekspos oleh Winusb.dll. Untuk menutup handel ini, panggil WinUsb_Free.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
ERROR_ALREADY_EXISTS	WinUsb_GetAssociatedInterface telah mengembalikan handel untuk antarmuka yang ditentukan AssociatedInterfaceIndex .
ERROR_INVALID_HANDLE	Pemanggil melewati NULL dalam parameter InterfaceHandle .
ERROR_INVALID_PARAMETER	Nilai AssociatedInterfaceIndex yang diteruskan gagal dalam pemeriksaan luapan bilangan bulat.
ERROR_NO_MORE_ITEMS	Antarmuka tidak ada untuk nilai AssociatedInterfaceIndex yang ditentukan.
ERROR_NOT_ENOUGH_MEMORY	Menunjukkan bahwa memori tidak cukup untuk melakukan operasi.

Keterangan

Rutinitas WinUsb_GetAssociatedInterface mengambil handel buram.

Antarmuka terkait pertama adalah antarmuka yang segera mengikuti antarmuka yang menangani WinUsb_Initialize rutin diambil.

Handel yang dikembalikan WinUsb_GetAssociatedInterface harus dirilis dengan memanggil WinUsb_Free.

Penelepon WinUsb_GetAssociatedInterface hanya dapat mengambil satu handel untuk setiap antarmuka. Jika penelepon mencoba mengambil lebih dari satu handel untuk antarmuka yang sama, rutinitas akan gagal dengan kesalahan ERROR_ALREADY_EXISTS.