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