Fonction PowerCreatePossibleSetting (powrprof.h)

Crée une valeur de paramètre possible pour un paramètre d’alimentation spécifié.

Syntaxe

DWORD PowerCreatePossibleSetting(
  [in, optional] HKEY       RootSystemPowerKey,
  [in]           const GUID *SubGroupOfPowerSettingsGuid,
  [in]           const GUID *PowerSettingGuid,
  [in]           ULONG      PossibleSettingIndex
);

Paramètres

[in, optional] RootSystemPowerKey

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

[in] SubGroupOfPowerSettingsGuid

Sous-groupe des paramètres d’alimentation. Ce paramètre peut être l’une des valeurs suivantes définies dans WinNT.h.

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

Identificateur du paramètre d’alimentation en cours de création.

[in] PossibleSettingIndex

Index de base zéro pour le paramètre possible en cours de création.

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é.

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

Fonctions de gestion de l’alimentation