WinUsb_GetPipePolicy (winusb.h)

Artikel
08/27/2023

Fungsi WinUsb_GetPipePolicy mengambil kebijakan untuk pipa tertentu yang terkait dengan titik akhir pada perangkat. Ini adalah operasi sinkron.

Sintaks

BOOL WinUsb_GetPipePolicy(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      UCHAR                   PipeID,
  [in]      ULONG                   PolicyType,
  [in, out] PULONG                  ValueLength,
  [out]     PVOID                   Value
);

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] PipeID

Nilai 8-bit yang terdiri dari alamat 7-bit dan bit arah. Parameter ini sesuai dengan bidang bEndpointAddress di deskriptor titik akhir.

[in] PolicyType

Variabel ULONG yang menentukan parameter kebijakan yang akan diambil. Nilai saat ini untuk parameter kebijakan diambil parameter Nilai . Untuk informasi tentang perilaku kebijakan pipa, lihat Fungsi WinUSB untuk Modifikasi Kebijakan Pipa.

[in, out] ValueLength

Penunjuk ke ukuran, dalam byte, dari buffer yang dirujuk Nilai . Pada output, ValueLength menerima ukuran, dalam byte, dari data yang disalin ke dalam buffer Nilai .

[out] Value

Penunjuk ke buffer yang menerima nilai kebijakan pipa yang ditentukan.

Mengembalikan nilai

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

GetLastError dapat mengembalikan kode kesalahan berikut.