Funzione PowerReadDCValue (powersetting.h)

Articolo
08/25/2023

Recupera il valore di alimentazione del controller di dominio per l'impostazione di alimentazione specificata.

Sintassi

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
);

Parametri

[in, optional] RootPowerKey

Questo parametro è riservato per uso futuro e deve essere impostato su NULL.

[in, optional] SchemeGuid

Identificatore dello schema di alimentazione.

[in, optional] SubGroupOfPowerSettingsGuid

Sottogruppo di impostazioni di risparmio energia. Questo parametro può essere uno dei valori seguenti definiti in WinNT.h. Usare NO_SUBGROUP_GUID per recuperare l'impostazione per lo schema di alimentazione predefinito.

Valore	Significato
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	Le impostazioni in questo sottogruppo fanno parte dello schema di alimentazione predefinito.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	Le impostazioni in questo sottogruppo controllano la configurazione del risparmio energia delle unità disco rigido del sistema.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Le impostazioni in questo sottogruppo controllano la configurazione dei pulsanti di alimentazione del sistema.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Le impostazioni in questo sottogruppo controllano la configurazione delle funzionalità di risparmio energia del processore.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Le impostazioni in questo sottogruppo controllano la configurazione delle funzionalità di risparmio energia video.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Le impostazioni in questo sottogruppo controllano i punti e le azioni di allarme della batteria.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Impostazioni in questo sottogruppo controllano le impostazioni di sospensione del sistema.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Le impostazioni in questo sottogruppo controllano le impostazioni di PCI Express.

[in, optional] PowerSettingGuid

Identificatore dell'impostazione di alimentazione.

[out, optional] Type

Puntatore a una variabile che riceve il tipo di dati per il valore. I valori possibili sono elencati in Tipi di valore del Registro di sistema. Questo parametro può essere NULL e il tipo di dati non viene restituito.

[out, optional] Buffer

Puntatore a una variabile che riceve il valore di dati. Se questo parametro è NULL, il parametro BufferSize riceve le dimensioni del buffer necessarie.

[in, out] BufferSize

Puntatore a una variabile che contiene le dimensioni del buffer a cui punta il parametro Buffer .

Se il parametro Buffer è NULL, la funzione restituisce ERROR_SUCCESS e la variabile riceve le dimensioni del buffer necessarie.

Se le dimensioni del buffer specificate non sono sufficienti per contenere i dati richiesti, la funzione restituisce ERROR_MORE_DATA e la variabile riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce ERROR_SUCCESS (zero) se la chiamata ha avuto esito positivo e un valore diverso da zero se la chiamata non è riuscita. Se la dimensione del buffer specificata dal parametro BufferSize è troppo piccola, ERROR_MORE_DATA verrà restituita e la DWORD a cui punta il parametro BufferSize verrà riempita con le dimensioni del buffer necessarie.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	powersetting.h
Libreria	PowrProf.lib
DLL	PowrProf.dll

Vedi anche

Funzioni di risparmio energia

Condividi tramite