WriteProcessorPwrScheme, fonction (powrprof.h)

[WriteProcessorPwrScheme peut être utilisé dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Voir Les remarques.]

Écrit les paramètres de stratégie d’alimentation du processeur pour le schéma d’alimentation spécifié.

Syntaxe

BOOLEAN WriteProcessorPwrScheme(
  [in] UINT                            uiID,
  [in] PMACHINE_PROCESSOR_POWER_POLICY pMachineProcessorPowerPolicy
);

Paramètres

[in] uiID

Index du schéma d’alimentation à écrire.

[in] pMachineProcessorPowerPolicy

Pointeur vers une structure de MACHINE_PROCESSOR_POWER_POLICY qui contient les paramètres de stratégie d’alimentation à écrire.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette modification n’affecte pas la stratégie d’alimentation système actuelle. Pour appliquer cette modification à la stratégie d’alimentation système actuelle, appelez la fonction SetActivePwrScheme à l’aide de l’index de ce schéma d’alimentation.

À compter de Windows Vista, la configuration de la gestion de l’alimentation du processeur du système est contrôlée par le sous-groupe GUID_PROCESSOR_SETTINGS_SUBGROUP paramètres d’alimentation. Utilisez la fonction PowerEnumerate pour énumérer des paramètres individuels.

Pour plus d’informations sur l’utilisation de PowrProf.h, consultez Power Schemes.

Configuration requise

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

Voir aussi

MACHINE_PROCESSOR_POWER_POLICY

Fonctions de gestion de l’alimentation

Schémas d’alimentation

ReadProcessorPwrScheme