Fonction PowerWriteValueUnitsSpecifier (powrprof.h)

Article
08/25/2023

Écrit la chaîne utilisée pour décrire les unités d’un paramètre d’alimentation qui prend en charge une plage de valeurs. Par exemple, « minutes » peut être utilisé pour décrire un paramètre de délai d’expiration.

Syntaxe

DWORD PowerWriteValueUnitsSpecifier(
  [in, optional] HKEY       RootPowerKey,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [in]           UCHAR      *Buffer,
  [in]           DWORD      BufferSize
);

Paramètres

[in, optional] RootPowerKey

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

[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 faire référence au 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, optional] PowerSettingGuid

Identificateur du paramètre d’alimentation.

[in] Buffer

Spécificateur d’unités, en caractères larges (Unicode).

[in] BufferSize

Taille de la mémoire tampon pointée vers le paramètre Buffer .

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

Notes

Les modifications apportées aux paramètres du schéma d’alimentation actif n’entrent pas en vigueur tant que vous n’appelez pas la fonction PowerSetActiveScheme .

Spécifications


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