fungsi WinUsb_GetAssociatedInterface (winusb.h)
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 |
---|---|
|
WinUsb_GetAssociatedInterface telah mengembalikan handel untuk antarmuka yang ditentukan AssociatedInterfaceIndex . |
|
Pemanggil melewati NULL dalam parameter InterfaceHandle . |
|
Nilai AssociatedInterfaceIndex yang diteruskan gagal dalam pemeriksaan luapan bilangan bulat. |
|
Antarmuka tidak ada untuk nilai AssociatedInterfaceIndex yang ditentukan. |
|
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | winusb.h (termasuk Winusb.h) |
Pustaka | Winusb.lib |
DLL | Winusb.dll |