WinUsb_QueryPipeEx (winusb.h)

Artikel
03/04/2024

Fungsi WinUsb_QueryPipeEx mengambil informasi yang diperluas tentang titik akhir yang ditentukan dan pipa terkait untuk antarmuka.

Sintaks

BOOL WinUsb_QueryPipeEx(
  [in]  WINUSB_INTERFACE_HANDLE     InterfaceHandle,
  [in]  UCHAR                       AlternateSettingNumber,
  [in]  UCHAR                       PipeIndex,
  [out] PWINUSB_PIPE_INFORMATION_EX PipeInformationEx
);

Parameter

[in] InterfaceHandle

Handel buram ke antarmuka yang berisi titik akhir tempat pipa dikaitkan.

Untuk mengkueri pipa yang terkait dengan titik akhir di antarmuka pertama, gunakan handel yang dikembalikan oleh WinUsb_Initialize. Untuk semua antarmuka lainnya, gunakan handel ke antarmuka target, yang diambil oleh WinUsb_GetAssociatedInterface.

[in] AlternateSettingNumber

Nilai yang menentukan antarmuka alternatif untuk mengembalikan informasi.

[in] PipeIndex

Nilai yang menentukan pipa untuk mengembalikan informasi tentang. Nilai ini tidak sama dengan bidang bEndpointAddress di deskriptor titik akhir. Nilai PipeIndex 0 menandakan titik akhir pertama yang terkait dengan antarmuka, nilai 1 menandakan titik akhir kedua, dan sebagainya. PipeIndex harus kurang dari nilai di bidang bNumEndpoints dari deskriptor antarmuka.

[out] PipeInformationEx

Penunjuk, pada output, ke struktur WINUSB_PIPE_INFORMATION_EX yang dialokasikan pemanggil yang berisi informasi pipa.

Mengembalikan nilai

WinUsb_QueryPipeEx 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 .
ERROR_INVALID_PARAMETER	Penelepon melewati NULL dalam parameter PipeInformation ; deskriptor antarmuka tidak dapat ditemukan untuk handel yang ditentukan dalam InterfaceHandle.
ERROR_NO_MORE_ITEMS	Nilai yang diteruskan dalam parameter PipeIndex lebih besar dari nilai bNumEndpoints dari deskriptor antarmuka; deskriptor titik akhir tidak dapat ditemukan untuk antarmuka yang ditentukan.