Funzione PowerEnumerate (powrprof.h)

Articolo
03/01/2024

Enumera gli elementi specificati in uno schema di alimentazione. Questa funzione viene normalmente chiamata in un ciclo che incrementa il parametro Index per recuperare le sottochiavi fino a quando non sono state enumerate.

Sintassi

DWORD PowerEnumerate(
  [in, optional]  HKEY                RootPowerKey,
  [in, optional]  const GUID          *SchemeGuid,
  [in, optional]  const GUID          *SubGroupOfPowerSettingsGuid,
  [in]            POWER_DATA_ACCESSOR AccessFlags,
  [in]            ULONG               Index,
  [out, optional] UCHAR               *Buffer,
  [in, out]       DWORD               *BufferSize
);

Parametri

[in, optional] RootPowerKey

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

[in, optional] SchemeGuid

Identificatore dello schema di alimentazione. Se questo parametro è NULL, viene restituita un'enumerazione dei criteri di alimentazione.

[in, optional] SubGroupOfPowerSettingsGuid

Sottogruppo di impostazioni di alimentazione. Se questo parametro è NULL, viene restituita un'enumerazione delle impostazioni nella chiave PolicyGuid .

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] AccessFlags

Set di flag che specificano cosa verrà enumerato

Valore	Significato
ACCESS_SCHEME 16	Enumera schemi di alimentazione. I parametri SchemeGuid e SubgroupOfPowerSettingsGuid verranno ignorati.
ACCESS_SUBGROUP 17	Enumerare i sottogruppi in SchemeGuid. Il parametro SubgroupOfPowerSettingsGuid verrà ignorato .
ACCESS_INDIVIDUAL_SETTING 18	Enumerare le singole impostazioni di alimentazione in SchemeGuid\SubgroupOfPowerSettingsGuid. Per enumerare le impostazioni di alimentazione direttamente nella chiave SchemeGuid , usare NO_SUBGROUP_GUID come parametro SubgroupOfPowerSettingsGuid .

[in] Index

Indice in base zero dello schema, del sottogruppo o dell'impostazione in corso di enumerazione.

[out, optional] Buffer

Puntatore a una variabile per ricevere gli elementi. Se questo parametro è NULL, la funzione recupera le dimensioni del buffer richiesto.

[in, out] BufferSize

Puntatore a una variabile che in input contiene le dimensioni del buffer a cui punta il parametro Buffer . Se il parametro Buffer è NULL o se BufferSize non è abbastanza grande, la funzione restituirà ERROR_MORE_DATA e la variabile riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce ERROR_SUCCESS (zero) se la chiamata ha esito positivo e un valore diverso da zero se la chiamata non è riuscita. Se le dimensioni del buffer passate nel parametro BufferSize sono troppo piccole o se il parametro Buffer è NULL, ERROR_MORE_DATA verrà restituito e il parametro DWORD puntato al parametro BufferSize verrà compilato 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	powrprof.h
Libreria	PowrProf.lib
DLL	PowrProf.dll

Vedi anche

POWER_DATA_ACCESSOR

Funzioni di risparmio energia

Condividi tramite