Función WriteProcessorPwrScheme (powrprof.h)

[WriteProcessorPwrScheme está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. Vea comentarios.]

Escribe la configuración de la directiva de energía del procesador para el esquema de energía especificado.

Sintaxis

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

Parámetros

[in] uiID

Índice del esquema de energía que se va a escribir.

[in] pMachineProcessorPowerPolicy

Puntero a una estructura de MACHINE_PROCESSOR_POWER_POLICY que contiene la configuración de la directiva de energía que se va a escribir.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Este cambio no afecta a la directiva actual de energía del sistema. Para aplicar este cambio a la directiva de energía del sistema actual, llame a la función SetActivePwrScheme mediante el índice de este esquema de energía.

A partir de Windows Vista, la configuración de administración de energía del procesador del sistema se controla a través del subgrupo de configuración de energía de GUID_PROCESSOR_SETTINGS_SUBGROUP. Use la función PowerEnumerate para enumerar la configuración individual.

Para obtener más información sobre el uso de PowrProf.h, consulte Esquemas de energía.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	powrprof.h
Library	PowrProf.lib
Archivo DLL	PowrProf.dll

Consulte también

MACHINE_PROCESSOR_POWER_POLICY

Funciones de administración de energía

Esquemas de energía

ReadProcessorPwrScheme