Bagikan melalui


WinUsb_GetPipePolicy (winusb.h)

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.

Menampilkan kode Deskripsi
ERROR_INVALID_HANDLE
Pemanggil melewati NULL dalam parameter InterfaceHandle .

Persyaratan

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

Lihat juga

WinUSB

Fungsi WinUSB

Fungsi WinUSB untuk Modifikasi Kebijakan Pipa

WinUsb_Initialize

WinUsb_ReadPipe

WinUsb_WritePipe