Partager via


Fonction PowerEnumerate (powrprof.h)

Énumère les éléments spécifiés dans un schéma d’alimentation. Cette fonction est normalement appelée dans une boucle incrémentant le paramètre Index pour récupérer les sous-clés jusqu’à ce qu’elles soient toutes énumérées.

Syntaxe

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

Paramètres

[in, optional] RootPowerKey

Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur NULL.

[in, optional] SchemeGuid

Identificateur du schéma d’alimentation. Si ce paramètre a la valeur NULL, une énumération des stratégies d’alimentation est retournée.

[in, optional] SubGroupOfPowerSettingsGuid

Sous-groupe des paramètres d’alimentation. Si ce paramètre a la valeur NULL, une énumération des paramètres sous la clé PolicyGuid est retournée.

Valeur Signification
NO_SUBGROUP_GUID
fea3413e-7e05-4911-9a71-700331f1c294
Les paramètres de ce sous-groupe font partie du schéma d’alimentation par défaut.
GUID_DISK_SUBGROUP
0012ee47-9041-4b5d-9b77-535fba8b1442
Les paramètres de ce sous-groupe contrôlent la configuration de la gestion de l’alimentation des lecteurs de disque dur du système.
GUID_SYSTEM_BUTTON_SUBGROUP
4f971e89-eebd-4455-a8de-9e59040e7347
Les paramètres de ce sous-groupe contrôlent la configuration des boutons d’alimentation système.
GUID_PROCESSOR_SETTINGS_SUBGROUP
54533251-82be-4824-96c1-47b60b740d00
Les paramètres de ce sous-groupe contrôlent la configuration des fonctionnalités de gestion de l’alimentation du processeur.
GUID_VIDEO_SUBGROUP
7516b95f-f776-4464-8c53-06167f40cc99
Les paramètres de ce sous-groupe contrôlent la configuration des fonctionnalités de gestion de l’alimentation vidéo.
GUID_BATTERY_SUBGROUP
e73a048d-bf27-4f12-9731-8b2076e8891f
Les paramètres de ce sous-groupe contrôlent les points de déclenchement et les actions de l’alarme de batterie.
GUID_SLEEP_SUBGROUP
238C9FA8-0AAD-41ED-83F4-97BE242C8F20
Les paramètres de ce sous-groupe contrôlent les paramètres de veille système.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP
501a4d13-42af-4429-9fd1-a8218c268e20
Les paramètres de ce sous-groupe contrôlent les paramètres PCI Express.

[in] AccessFlags

Ensemble d’indicateurs qui spécifie ce qui sera énuméré

Valeur Signification
ACCESS_SCHEME
16
Énumérer les schémas d’alimentation. Les paramètres SchemeGuid et SubgroupOfPowerSettingsGuid seront ignorés.
ACCESS_SUBGROUP
17
Énumérez les sous-groupes sous SchemeGuid. Le paramètre SubgroupOfPowerSettingsGuid est ignoré.
ACCESS_INDIVIDUAL_SETTING
18
Énumérez les paramètres d’alimentation individuels sous SchemeGuid\Sous-groupeOfPowerSettingsGuid. Pour énumérer les paramètres d’alimentation directement sous la clé SchemeGuid , utilisez NO_SUBGROUP_GUID comme paramètre SubgroupOfPowerSettingsGuid .

[in] Index

Index de base zéro du schéma, du sous-groupe ou du paramètre énuméré.

[out, optional] Buffer

Pointeur vers une variable pour recevoir les éléments. Si ce paramètre a la valeur NULL, la fonction récupère la taille de la mémoire tampon requise.

[in, out] BufferSize

Pointeur vers une variable qui, à l’entrée, contient la taille de la mémoire tampon pointée par le paramètre Buffer . Si le paramètre Buffer a la valeur NULL ou si bufferSize n’est pas suffisamment grand, la fonction retourne ERROR_MORE_DATA et la variable reçoit la taille de mémoire tampon requise.

Valeur retournée

Retourne ERROR_SUCCESS (zéro) si l’appel a réussi, et une valeur différente de zéro si l’appel a échoué. Si la taille de mémoire tampon passée dans le paramètre BufferSize est trop petite, ou si le paramètre Buffer a la valeur NULL, ERROR_MORE_DATA est retourné et le DWORD pointé par le paramètre BufferSize est rempli avec la taille de mémoire tampon requise.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête powrprof.h
Bibliothèque PowrProf.lib
DLL PowrProf.dll

Voir aussi

POWER_DATA_ACCESSOR

Fonctions de gestion de l’alimentation