PowerReadDCDefaultIndex, fonction (powrprof.h)

Article
03/04/2024

Récupère l’index DC par défaut du paramètre d’alimentation spécifié.

Syntaxe

DWORD PowerReadDCDefaultIndex(
  [in, optional] HKEY       RootPowerKey,
  [in]           const GUID *SchemePersonalityGuid,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in]           const GUID *PowerSettingGuid,
  [out]          LPDWORD    DcDefaultIndex
);

Paramètres

[in, optional] RootPowerKey

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

[in] SchemePersonalityGuid

Identificateur de la personnalité du schéma pour ce paramètre d’alimentation. Un paramètre d’alimentation peut avoir des valeurs par défaut différentes en fonction de la personnalité du schéma d’alimentation.

[in, optional] SubGroupOfPowerSettingsGuid

Sous-groupe des paramètres d’alimentation. Ce paramètre peut être l’une des valeurs suivantes définies dans WinNT.h. Utilisez NO_SUBGROUP_GUID pour récupérer le paramètre du schéma d’alimentation par défaut.

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

Identificateur du paramètre d’alimentation.

[out] DcDefaultIndex

Pointeur vers une variable qui reçoit l’index dc par défaut.

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