WinUsb_GetPowerPolicy (winusb.h)

Artikel
08/27/2023

Fungsi WinUsb_GetPowerPolicy mengambil kebijakan daya untuk perangkat. Ini adalah operasi sinkron.

Sintaks

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

Parameter

[in] InterfaceHandle

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

[in] PolicyType

Nilai yang menentukan parameter kebijakan daya untuk diambil di Nilai. Tabel berikut ini menjelaskan konstanta simbolis yang didefinisikan dalam Winusbio.h.

Jenis kebijakan	Deskripsi
AUTO_SUSPEND (0x81)	Jika pemanggil menentukan kebijakan daya AUTO_SUSPEND, WinUsb_GetPowerPolicy mengembalikan nilai parameter kebijakan penangguhan otomatis dalam parameter Nilai . Jika Value is TRUE (yaitu, nonzero), tumpukan USB menangguhkan perangkat ketika tidak ada transfer yang tertunda atau satu-satunya transfer yang tertunda adalah transfer IN pada titik akhir interupsi atau massal. Nilai registri DefaultIdleState menentukan nilai default parameter kebijakan penangguhan otomatis. Parameter Nilai harus menunjuk ke variabel UCHAR.
SUSPEND_DELAY (0x83)	Jika penelepon menentukan kebijakan daya SUSPEND_DELAY, WinUsb_GetPowerPolicy mengembalikan nilai parameter kebijakan penundaan yang ditangguhkan di Nilai. Parameter kebijakan penundaan yang ditangguhkan menentukan jumlah waktu minimum, dalam milidetik, bahwa driver WinUSB harus menunggu setelah transfer apa pun sebelum dapat menangguhkan perangkat. Nilai harus menunjuk ke variabel ULONG.

Jenis kebijakan

Deskripsi

AUTO_SUSPEND

(0x81)

Jika pemanggil menentukan kebijakan daya AUTO_SUSPEND, WinUsb_GetPowerPolicy mengembalikan nilai parameter kebijakan penangguhan otomatis dalam parameter Nilai .

Jika Value is TRUE (yaitu, nonzero), tumpukan USB menangguhkan perangkat ketika tidak ada transfer yang tertunda atau satu-satunya transfer yang tertunda adalah transfer IN pada titik akhir interupsi atau massal.

Nilai registri DefaultIdleState menentukan nilai default parameter kebijakan penangguhan otomatis.

Parameter Nilai harus menunjuk ke variabel UCHAR.

SUSPEND_DELAY

(0x83)

Jika penelepon menentukan kebijakan daya SUSPEND_DELAY, WinUsb_GetPowerPolicy mengembalikan nilai parameter kebijakan penundaan yang ditangguhkan di Nilai.

Parameter kebijakan penundaan yang ditangguhkan menentukan jumlah waktu minimum, dalam milidetik, bahwa driver WinUSB harus menunggu setelah transfer apa pun sebelum dapat menangguhkan perangkat.

Nilai harus menunjuk ke variabel ULONG.

[in, out] ValueLength

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

[out] Value

Buffer yang menerima parameter kebijakan daya yang ditentukan. Untuk informasi selengkapnya, lihat PolicyType.

Nilai kembali

WinUsb_GetPowerPolicy 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.