ReadProcessorPwrScheme, fonction (powrprof.h)

[ReadProcessorPwrScheme 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.]

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

Syntaxe

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

Paramètres

[in] uiID

Index du schéma d’alimentation à lire.

[out] pMachineProcessorPowerPolicy

Pointeur vers une structure MACHINE_PROCESSOR_POWER_POLICY qui reçoit les paramètres de stratégie d’alimentation du processeur.

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

La structure MACHINE_PROCESSOR_POWER_POLICY contient les paramètres de stratégie d’alimentation du processeur à utiliser lorsque le système s’exécute sur l’alimentation secteur ou sur batterie.

À 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

Voir aussi

MACHINE_PROCESSOR_POWER_POLICY

Fonctions de gestion de l’alimentation

Schémas d’alimentation

WriteProcessorPwrScheme