PowerReadDCValueIndex, fonction (powrprof.h)

Article
03/04/2024

Récupère l’index de valeur du contrôleur de domaine du paramètre d’alimentation spécifié.

Syntaxe

DWORD PowerReadDCValueIndex(
  [in, optional] HKEY       RootPowerKey,
  [in, optional] const GUID *SchemeGuid,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [out]          LPDWORD    DcValueIndex
);

Paramètres

[in, optional] RootPowerKey

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

[in, optional] SchemeGuid

Identificateur du schéma d’alimentation.

[in, optional] SubGroupOfPowerSettingsGuid

Identificateur du sous-groupe des paramètres d’alimentation. Utilisez NO_SUBGROUP_GUID pour faire référence au schéma d’alimentation par défaut.

Ces valeurs sont les valeurs de sous-groupe incluses dans Windows.

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 gestion de l’alimentation des disques durs du système.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Paramètres dans cette configuration de contrôle de sous-groupe des boutons d’alimentation système.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Paramètres dans cette configuration de contrôle de sous-groupe des fonctionnalités de gestion de l’alimentation du processeur.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Paramètres dans cette configuration de contrôle de sous-groupe 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	Paramètres de ce sous-groupe contrôlent les paramètres de veille du système de contrôle.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Les paramètres de ce sous-groupe contrôlent les paramètres PCI Express.

[in, optional] PowerSettingGuid

Identificateur du paramètre d’alimentation.

[out] DcValueIndex

Pointeur vers une variable qui reçoit l’index de valeur du contrôleur de domaine.

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

Partager via