Fonction SetActivePwrScheme (powrprof.h)

[SetActivePwrScheme est disponible pour une utilisation 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. Les applications écrites pour Windows Vista et versions ultérieures doivent utiliser PowerSetActiveScheme à la place.]

Définit le schéma d’alimentation actif.

Syntaxe

BOOLEAN SetActivePwrScheme(
  [in]           UINT                 uiID,
  [in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
  [in, optional] PPOWER_POLICY        pPowerPolicy
);

Paramètres

[in] uiID

Index du schéma d’alimentation à activer.

[in, optional] pGlobalPowerPolicy

Pointeur vers une structure de GLOBAL_POWER_POLICY facultative, qui fournit des paramètres de stratégie d’alimentation globale à fusionner avec le schéma d’alimentation lorsqu’il devient actif.

[in, optional] pPowerPolicy

Pointeur vers une structure de POWER_POLICY facultative, qui fournit les paramètres de stratégie d’alimentation à fusionner avec le schéma d’alimentation lorsqu’il devient actif.

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

Utilisez cette fonction pour apporter des modifications à long terme à la configuration système. Pour maintenir temporairement le système en cours d’exécution pendant qu’une application exécute une tâche, utilisez la fonction SetThreadExecutionState .

Si le schéma d’alimentation spécifié par uiID n’existe pas, la fonction retourne zéro.

Si lpGlobalPowerPolicy a la valeur NULL, la fonction utilise les paramètres de stratégie d’alimentation globale actuels définis par WriteGlobalPwrPolicy. Dans le cas contraire, les paramètres de la structure spécifiée remplacent les paramètres de stratégie d’alimentation globale actuels.

Si lpPowerPolicy a la valeur NULL, la fonction utilise les paramètres de stratégie d’alimentation actuels pour le schéma d’alimentation. Dans le cas contraire, les paramètres de la structure spécifiée remplacent les paramètres actuels de la stratégie d’alimentation.

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

Configuration requise

Voir aussi

GLOBAL_POWER_POLICY

GetActivePwrScheme

POWER_POLICY

Fonctions de gestion de l’alimentation

Schémas d’alimentation