GUID de configuración de energía
Los GUID de configuración de energía identifican los eventos de cambio de energía. En este tema se enumeran los GUID de configuración de energía para las notificaciones que son más útiles para las aplicaciones. Una aplicación debe registrar cada evento de cambio de energía que pueda afectar a su comportamiento. Cada vez que cambia una configuración se envía una notificación.
Los GUID de configuración de energía se definen en WinNT.h.
GUID_ACDC_POWER_SOURCE (5D3E9A59-E9D5-4B00-A6BD-FF34FF516548)
La fuente de alimentación del sistema ha cambiado.
El miembro Data es del tipo DWORD con un valor de la enumeración SYSTEM_POWER_CONDITION que indica la fuente de alimentación actual:
PoAc (0): el equipo está alimentado por una fuente de alimentación de CA (o similar, como un portátil con alimentación mediante un adaptador de automóvil de 12 V).
PoDc (1): el equipo está alimentado por una fuente de alimentación con batería incorporada.
PoHot (2): el equipo está alimentado por una fuente de alimentación a corto plazo, como un dispositivo SAI (UPS).
GUID_BATTERY_PERCENTAGE_REMAINING (A7AD8041-B45A-4CAE-87A3-EECBB468A9E1)
La capacidad restante de la batería ha cambiado. La granularidad varía de sistema a sistema, pero la granularidad más precisa es del 1 %.
El miembro Data es de un tipo DWORD que indica la capacidad restante actual de la batería como un porcentaje comprendido entre 0 y 100.
GUID_CONSOLE_DISPLAY_STATE (6FE69556-704A-47A0-8F24-C28D936FDA47)
El estado de visualización del monitor actual ha cambiado.
Windows 7, Windows Server 2008 R2, Windows Vista y Windows Server 2008: esta notificación está disponible a partir de Windows 8 y Windows Server 2012.
El miembro Data es de un tipo DWORD con un valor de la enumeración MONITOR_DISPLAY_STATE:
PowerMonitorOff (0): la pantalla está apagada.
PowerMonitorOn (1): la pantalla está encendida.
PowerMonitorDim (2): la pantalla está atenuada.
GUID_GLOBAL_USER_PRESENCE (786E8A1D-B427-4344-9207-09E70BDCBEA9)
El estado del usuario asociado a cualquier sesión ha cambiado. Esto representa el estado combinado de la presencia del usuario en todas las sesiones locales y remotas del sistema.
Esta notificación solo se envía a servicios y otros programas que se ejecutan en la sesión 0. En su lugar, las aplicaciones en modo de usuario deben registrarse en GUID_SESSION_USER_PRESENCE.
Windows 7, Windows Server 2008 R2, Windows Vista y Windows Server 2008: esta notificación está disponible a partir de Windows 8 y Windows Server 2012.
El miembro Data es de un tipo DWORD con uno de los siguientes valores de la enumeración USER_ACTIVITY_PRESENCE:
PowerUserPresent (0): el usuario está presente en cualquier sesión local o remota del sistema.
PowerUserInactive (2): el usuario no está presente en ninguna sesión local o remota del sistema.
GUID_IDLE_BACKGROUND_TASK (515C31D8-F734-163D-A0FD-11A08C91E8F1)
El sistema está ocupado. Esto indica que el sistema no pasará al modo de administración de energía en estado de inactividad en un futuro próximo y que la hora actual es un buen momento para que los componentes realicen tareas en segundo plano que, de llevarse a cabo en otro momento, impedirían que el equipo entrara en un estado inactivo.
No hay ninguna notificación sobre cuándo pasará el sistema a un estado inactivo. La notificación de tarea en segundo plano inactiva no indica si un usuario está presente en el equipo.
El miembro Data no tiene información y se puede omitir.
GUID_LIDSWITCH_STATE_CHANGE (BA3E0F4D-B817-4094-A2D1-D56379E6A0F3)
El estado de la tapa ha cambiado (abierto en lugar de cerrado). No se efectuará la devolución de llamada hasta que se encuentre un dispositivo de tapa y se conozca su estado actual.
0x0: la tapa está cerrada.
0x1: la tapa está abierta.
GUID_MONITOR_POWER_ON (02731015-4510-4526-99E6-E5A17EBD1AEA)
El monitor del sistema principal se ha encendido o apagado. Esta notificación es útil para los componentes que representan activamente contenido en el dispositivo de visualización, como la visualización de contenido multimedia. Las aplicaciones deben registrarse para recibir esta notificación y dejar de representar contenido gráfico cuando el monitor está apagado para reducir el consumo de energía del sistema.
El miembro Data es de un tipo DWORD que indica el estado actual del monitor:
0x0: el monitor está apagado.
0x1: el monitor está encendido.
Windows 8 y Windows Server 2012: las nuevas aplicaciones deben usar GUID_CONSOLE_DISPLAY_STATE en lugar de esta notificación.
GUID_POWER_SAVING_STATUS (E00958C0-C213-4ACE-AC77-FECCED2EEEA5)
El ahorro de batería se ha desactivado o activado en respuesta a las condiciones de energía cambiantes. Esta notificación es útil para los componentes que participan en la conservación de la energía. Las aplicaciones deben registrarse para esta notificación y ahorrar energía cuando el ahorro de batería está activado.
El miembro Data es de un tipo DWORD que indica el estado del ahorro de batería:
0x0: el ahorro de batería está desactivado.
0x1: el ahorro de batería está activado. Ahorre energía siempre que sea posible.
Para obtener información general sobre el ahorro de batería, consulte Ahorro de batería (en las directrices del componente de hardware).
GUID_ENERGY_SAVER_STATUS (550E8400-E29B-41D4-A716-446655440000)
Importante
Esta información hace referencia a un producto de versión preliminar que puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no proporciona ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.
El estado del ahorro de energía ha cambiado. Esta notificación es útil para los componentes que participan en la conservación de la energía. Las aplicaciones que se registran para esta notificación pueden ahorrar distintos grados de energía en función del modo de ahorro de energía que esté en vigor.
El miembro Datos es un DWORD con valores de la enumeración ENERGY_SAVER_STATUS que indica el estado actual del ahorro de energía.
ENERGY_SAVER_OFF: el ahorro de energía está desactivado.
ENERGY_SAVER_STANDARD: el ahorro de energía está en modo estándar. Ahorre energía si el impacto en la experiencia del usuario es mínimo.
ENERGY_SAVER_HIGH_SAVINGS: el ahorro de energía está en modo de ahorro elevado. Ahorre energía siempre que sea posible.
GUID_POWERSCHEME_PERSONALITY (245D8541-3943-4422-B025-13A784F679B7)
La personalidad activa del plan de energía ha cambiado. Todos los planes de energía se asignan a una de estas personalidades.
El miembro Data es un GUID que indica la nueva personalidad del plan de energía activo:
GUID_MIN_POWER_SAVINGS (8C5E7FDA-E8BF-4A96-9A85-A6E23A8C635C)
Alto rendimiento: el plan está diseñado para ofrecer el máximo rendimiento a costa del ahorro de consumo de energía.
GUID_MAX_POWER_SAVINGS (A1841308-3541-4FAB-BC81-F71556F20B4A)
Ahorro de energía: el plan está diseñado para ofrecer el máximo ahorro de consumo de energía a costa del rendimiento y la capacidad de respuesta del sistema.
GUID_TYPICAL_POWER_SAVINGS (381B4222-F694-41F0-9685-FF5BB260DF2E)
Automático: el plan está diseñado para encontrar automáticamente un equilibrio entre el rendimiento y el ahorro de consumo de energía.
GUID_SESSION_DISPLAY_STATUS (2B84C20E-AD23-4DDF-93DB-05FFBD7EFCA5)
La pantalla asociada a la sesión de la aplicación se ha encendido o apagado.
Windows 7, Windows Server 2008 R2, Windows Vista y Windows Server 2008: esta notificación está disponible a partir de Windows 8 y Windows Server 2012.
Esta notificación solo se envía a las aplicaciones en modo de usuario. Los servicios y otros programas que se ejecutan en la sesión 0 no reciben esta notificación.
El miembro Data es de un tipo DWORD con un valor de la enumeración MONITOR_DISPLAY_STATE:
PowerMonitorOff (0): la pantalla está apagada.
PowerMonitorOn (1): la pantalla está encendida.
PowerMonitorDim (2): la pantalla está atenuada.
Nota:
Todas las aplicaciones que se ejecuten en una sesión interactiva en modo de usuario deben usar esta configuración. Cuando las aplicaciones en modo kernel se registran para supervisar el estado, deben usar GUID_CONSOLE_DISPLAY_STATUS en su lugar.
GUID_SESSION_USER_PRESENCE (3C0F4548-C03F-4C4D-B9F2-237EDE686376)
El estado del usuario asociado a la sesión de la aplicación ha cambiado.
Windows 7, Windows Server 2008 R2, Windows Vista y Windows Server 2008: esta notificación está disponible a partir de Windows 8 y Windows Server 2012.
Esta notificación solo se envía a las aplicaciones en modo de usuario que se ejecutan en una sesión interactiva. Los servicios y otros programas que se ejecutan en la sesión 0 deben registrarse en GUID_GLOBAL_USER_PRESENCE.
El miembro Data es de un tipo DWORD con uno de los siguientes valores de la enumeración USER_ACTIVITY_PRESENCE:
PowerUserPresent (0): el usuario proporciona entradas a la sesión.
PowerUserInactive (2): el tiempo de espera de actividad del usuario ha transcurrido sin ninguna interacción por parte de este.
GUID_SYSTEM_AWAYMODE (98A7F580-01F7-48AA-9C0F-44352C29E5C0)
El sistema entra o sale del modo ausente.
El miembro Data es de un tipo DWORD que indica el estado actual del modo ausente:
0x0: el equipo ha salido del modo ausente.
0x1: el equipo ha entrado en modo ausente.
Requisitos
| Requisito | Valor |
|---|---|
| Encabezado |
|
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de