Fungsi PowerReadDCValue (powersetting.h)
Mengambil nilai daya DC untuk pengaturan daya yang ditentukan.
Sintaks
DWORD PowerReadDCValue(
[in, optional] HKEY RootPowerKey,
[in, optional] const GUID *SchemeGuid,
[in, optional] const GUID *SubGroupOfPowerSettingsGuid,
[in, optional] const GUID *PowerSettingGuid,
[out, optional] PULONG Type,
[out, optional] PUCHAR Buffer,
[in, out] LPDWORD BufferSize
);
Parameter
[in, optional] RootPowerKey
Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.
[in, optional] SchemeGuid
Pengidentifikasi skema daya.
[in, optional] SubGroupOfPowerSettingsGuid
Subgrup pengaturan daya. Parameter ini dapat menjadi salah satu nilai berikut yang ditentukan dalam WinNT.h. Gunakan NO_SUBGROUP_GUID untuk mengambil pengaturan untuk skema daya default.
[in, optional] PowerSettingGuid
Pengidentifikasi pengaturan daya.
[out, optional] Type
Penunjuk ke variabel yang menerima jenis data untuk nilai tersebut. Nilai yang mungkin tercantum dalam Jenis Nilai Registri. Parameter ini bisa NULL dan jenis data tidak dikembalikan.
[out, optional] Buffer
Penunjuk ke variabel yang menerima nilai data. Jika parameter ini NULL, parameter BufferSize menerima ukuran buffer yang diperlukan.
[in, out] BufferSize
Penunjuk ke variabel yang berisi ukuran buffer yang ditujukkan oleh parameter Buffer .
Jika parameter BufferADALAH NULL, fungsi mengembalikan ERROR_SUCCESS dan variabel menerima ukuran buffer yang diperlukan.
Jika ukuran buffer yang ditentukan tidak cukup besar untuk menyimpan data yang diminta, fungsi mengembalikan ERROR_MORE_DATA dan variabel menerima ukuran buffer yang diperlukan.
Nilai kembali
Mengembalikan ERROR_SUCCESS (nol) jika panggilan berhasil, dan nilai bukan nol jika panggilan gagal. Jika ukuran buffer yang ditentukan oleh parameter BufferSize terlalu kecil, ERROR_MORE_DATA akan dikembalikan dan DWORD yang ditunjukkan oleh parameter BufferSize akan diisi dengan ukuran buffer yang diperlukan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | powersetting.h |
Pustaka | PowrProf.lib |
DLL | PowrProf.dll |