Metode IWDFUsbTargetDevice::RetrievePowerPolicy (wudfusb.h)

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode RetrievePowerPolicy mengambil kebijakan daya WinUsb.

Sintaks

HRESULT RetrievePowerPolicy(
  [in]      ULONG PolicyType,
  [in, out] ULONG *ValueLength,
  [out]     PVOID Value
);

Parameter

[in] PolicyType

Jenis kebijakan daya WinUsb yang diminta driver UMDF.

[in, out] ValueLength

Penunjuk ke variabel yang, pada input, berisi ukuran, dalam byte, dari buffer yang disediakan RetrievePowerPolicy dalam Nilai. Pada output, parameter ini berisi ukuran yang diperlukan RetrievePowerPolicy untuk Value.

[out] Value

Pointer yang menerima buffer yang berisi kebijakan daya WinUsb.

Nilai kembali

RetrievePowerPolicy mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
S_OK	RetrievePowerPolicy berhasil mengambil kebijakan daya WinUsb.
E_OUTOFMEMORY	RetrievePowerPolicy mengalami kegagalan alokasi.
Kode kesalahan yang ditentukan dalam Winerror.h	Nilai ini sesuai dengan kode kesalahan yang dikembalikan API WinUsb.

Keterangan

Kebijakan daya mengontrol manajemen daya yang dilakukan WinUsb untuk perangkat.

Untuk informasi tentang jenis kebijakan valid yang dapat diteruskan driver UMDF untuk parameter PolicyType dan nilai yang dikembalikan kerangka kerja, lihat fungsi WinUsb_GetPowerPolicy .

Untuk informasi selengkapnya tentang perilaku daya WinUSB, lihat WinUSB Power Management.

Metode RetrievePowerPolicy menghasilkan permintaan UMDF dan secara sinkron mengirim permintaan ke target I/O.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1,5
Header	wudfusb.h (termasuk Wudfusb.h)
DLL	WUDFx.dll

Lihat juga

IWDFUsbTargetDevice

IWDFUsbTargetDevice::SetPowerPolicy

WinUsb_GetPowerPolicy