Funzione PowerWriteDescription (powrprof.h)

Articolo
03/01/2024

Imposta la descrizione per l'impostazione di alimentazione, il sottogruppo o lo schema specificati.

Sintassi

DWORD PowerWriteDescription(
  [in, optional] HKEY       RootPowerKey,
  [in]           const GUID *SchemeGuid,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [in]           UCHAR      *Buffer,
  [in]           DWORD      BufferSize
);

Parametri

[in, optional] RootPowerKey

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

[in] SchemeGuid

Identificatore dello schema di alimentazione.

[in, optional] SubGroupOfPowerSettingsGuid

Sottogruppo di impostazioni di alimentazione. Questo parametro può essere uno dei valori seguenti definiti in WinNT.h. Usare NO_SUBGROUP_GUID per fare riferimento allo schema di alimentazione predefinito.

Valore	Significato
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1f1c294	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 dei dischi rigidi del sistema.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Impostazioni in questa configurazione del controllo del sottogruppo dei pulsanti di alimentazione del sistema.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Impostazioni in questa configurazione del controllo del sottogruppo delle funzionalità di risparmio energia del processore.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Impostazioni in questa configurazione del controllo del sottogruppo delle funzionalità di gestione energia video.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Impostazioni in questo sottogruppo controllano i punti di allarme della batteria e le azioni.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Impostazioni in questa impostazioni del sistema di sospensione del sottogruppo.
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.

[in] Buffer

Descrizione, in caratteri Wide (Unicode).

[in] BufferSize

Dimensioni del buffer a cui punta il parametro Buffer .

Valore restituito

Restituisce ERROR_SUCCESS (zero) se la chiamata ha esito positivo e un valore diverso da zero se la chiamata non è riuscita.

Commenti

Se il parametro SchemeGuid non è NULL , ma entrambi i parametri SubGroupOfPowerSettingsGuid e PowerSettingGuid sono NULL, la descrizione dello schema di alimentazione verrà impostata. Se i parametri SchemeGuid e SubGroupOfPowerSettingsGuid non sono NULL e il parametro PowerSettingGuid è NULL, verrà impostata la descrizione del sottogruppo. Se i parametri SchemeGuid, SubGroupOfPowerSettingsGuid e PowerSettingGuid non sono NULL, la descrizione dell'impostazione di alimentazione verrà impostata.

Le modifiche apportate alle impostazioni per lo schema di alimentazione attivo non vengono applicate finché non si chiama la funzione PowerSetActiveScheme .

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	powrprof.h
Libreria	PowrProf.lib
DLL	PowrProf.dll

Vedi anche

Funzioni di risparmio energia

Condividi tramite