GUIDs de Configuração de Energia
GUIDs de configuração de energia identificam eventos de mudança de energia. Este tópico lista GUIDs de configuração de energia para notificações que são mais úteis para aplicativos. Um aplicativo deve se registrar para cada evento de alteração de energia que possa afetar seu comportamento. A notificação é enviada sempre que uma configuração é alterada.
GUIDs de configuração de energia são definidos em WinNT.h.
GUID_ACDC_POWER_SOURCE (5D3E9A59-E9D5-4B00-A6BD-FF34FF516548)
A fonte de alimentação do sistema mudou.
O membro Data é um DWORD com um valor da enumeração SYSTEM_POWER_CONDITION que indica a fonte de alimentação atual:
PoAc (0) – o computador é alimentado por uma fonte de alimentação CA (ou similar, como um laptop alimentado por um adaptador automotivo de 12V).
PoDc (1) – O computador é alimentado por uma fonte de alimentação de bateria integrada.
PoHot (2) – O computador é alimentado por uma fonte de energia de curto prazo, como um dispositivo UPS.
GUID_BATTERY_PERCENTAGE_REMAINING (A7AD8041-B45A-4CAE-87A3-EECBB468A9E1)
A capacidade restante da bateria mudou. A granularidade varia de sistema para sistema, mas a menor granularidade é de 1%.
O membro Data é um DWORD que indica a capacidade atual da bateria restante como uma porcentagem de 0 a 100.
GUID_CONSOLE_DISPLAY_STATE (6FE69556-704A-47A0-8F24-C28D936FDA47)
O estado de exibição do monitor atual foi alterado.
Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: esta notificação está disponível a no Windows 8 e Windows Server 2012 e versões posteriores.
O membro Data é um DWORD com um valor da enumeração MONITOR_DISPLAY_STATE:
PowerMonitorOff (0) – a tela está desligada.
PowerMonitorOn (1) – a tela está ligada.
PowerMonitorDim (2) – A tela está esmaecida.
GUID_GLOBAL_USER_PRESENCE (786E8A1D-B427-4344-9207-09E70BDCBEA9)
O status do usuário associado a qualquer sessão foi alterado. Isso representa o status combinado da presença do usuário em todas as sessões locais e remotas no sistema.
Esta notificação é enviada apenas a serviços e outros programas em execução na sessão 0. Os aplicativos de modo de usuário devem se registrar para GUID_SESSION_USER_PRESENCE em vez disso.
Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: esta notificação está disponível a no Windows 8 e Windows Server 2012 e versões posteriores.
O membro Data é um DWORD com um dos seguintes valores da enumeração USER_ACTIVITY_PRESENCE:
PowerUserPresent (0) – o usuário está presente em qualquer sessão local ou remota no sistema.
PowerUserInactive (2) – o usuário não está presente em nenhuma sessão local ou remota no sistema.
GUID_IDLE_BACKGROUND_TASK (515C31D8-F734-163D-A0FD-11A08C91E8F1)
O sistema está ocupado. Isso indica que o sistema não entrará em um estado ocioso em um futuro próximo e que o tempo atual é um bom momento para que os componentes executem tarefas em segundo plano ou ociosas que, de outra forma, impediriam que o computador entrasse em um estado ocioso.
Não há notificação quando o sistema é capaz de passar para um estado ocioso. A notificação de tarefa em segundo plano ociosa não indica se um usuário está presente no computador.
O membro Data não tem informações e pode ser ignorado.
GUID_LIDSWITCH_STATE_CHANGE (BA3E0F4D-B817-4094-A2D1-D56379E6A0F3)
O estado da tampa mudou (aberta vs. fechada). O retorno de chamada não será chamado até que um dispositivo de tampa seja encontrado e o estado atual dele seja conhecido.
0x0 – a tampa está fechada.
0x1 – a tampa está aberta.
GUID_MONITOR_POWER_ON (02731015-4510-4526-99E6-E5A17EBD1AEA)
O monitor primário do sistema foi ligado ou desligado. Essa notificação é útil para componentes que renderizam ativamente o conteúdo para o dispositivo de vídeo, como visualização de mídia. Os aplicativos devem se registrar para essa notificação e parar de renderizar conteúdo gráfico quando o monitor estiver desativado para reduzir o consumo de energia do sistema.
O membro Data é um DWORD que indica o estado atual do monitor:
0x0 – o monitor está desligado.
0x1 – o monitor está ligado.
Windows 8 e Windows Server 2012: novos aplicativos devem usar GUID_CONSOLE_DISPLAY_STATE em vez dessa notificação.
GUID_POWER_SAVING_STATUS (E00958C0-C213-4ACE-AC77-FECCED2EEEA5)
A economia de bateria foi desligada ou ligada em resposta à mudança das condições de energia. Esta notificação é útil para componentes que participam na conservação de energia. Os aplicativos devem se registrar para enviar essa notificação e economizar energia quando a economia de bateria estiver ativada.
O membro Data é um DWORD que indica o estado de economia de bateria:
0x0 – a economia de bateria está desligada.
0x1 – a economia de bateria está ligada. Economize energia sempre que possível.
Para obter informações gerais sobre economia de bateria, consulte economia de bateria (nas diretrizes de componentes de hardware).
GUID_ENERGY_SAVER_STATUS (550E8400-E29B-41D4-A716-446655440000)
Importante
Essas informações estão relacionadas a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece nenhuma garantia, explícita ou implícita, quanto às informações fornecidas aqui.
O status da economia de energia foi alterado. Esta notificação é útil para componentes que participam na conservação de energia. Os aplicativos que se registram para enviar essa notificação podem economizar diferentes níveis de energia dependendo do modo de economia de energia em vigor.
O membro Dados é um DWORD com valores da enumeração ENERGY_SAVER_STATUS que indicam o status atual da economia de energia.
ENERGY_SAVER_OFF – a economia de energia está desativada.
ENERGY_SAVER_STANDARD – a economia de energia está no modo padrão. Economize energia se o impacto da experiência do usuário for mínimo.
ENERGY_SAVER_HIGH_SAVINGS – a economia de energia está no modo de alta economia. Economize energia sempre que possível.
GUID_POWERSCHEME_PERSONALITY (245D8541-3943-4422-B025-13A784F679B7)
A personalidade do esquema de energia ativo mudou. Todos os esquemas de energia são mapeados para uma dessas personalidades.
O membro Data é um GUID que indica a nova personalidade do esquema de energia ativo:
GUID_MIN_POWER_SAVINGS (8C5E7FDA-E8BF-4A96-9A85-A6E23A8C635C)
Alto desempenho – o esquema é projetado para oferecer o máximo desempenho às custas da economia no consumo de energia.
GUID_MAX_POWER_SAVINGS (A1841308-3541-4FAB-BC81-F71556F20B4A)
Economia de energia – o esquema foi projetado para proporcionar a máxima economia no consumo de energia às custas do desempenho e da capacidade de resposta do sistema.
GUID_TYPICAL_POWER_SAVINGS (381B4222-F694-41F0-9685-FF5BB260DF2E)
Automático – o esquema foi projetado para equilibrar automaticamente o desempenho e a economia no consumo de energia.
GUID_SESSION_DISPLAY_STATUS (2B84C20E-AD23-4DDF-93DB-05FFBD7EFCA5)
A tela associada à sessão do aplicativo foi ligada ou desligada.
Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: esta notificação está disponível a no Windows 8 e Windows Server 2012 e versões posteriores.
Essa notificação é enviada somente para aplicativos de modo de usuário. Os serviços e outros programas em execução na sessão 0 não recebem essa notificação.
O membro Data é um DWORD com um valor da enumeração MONITOR_DISPLAY_STATE:
PowerMonitorOff (0) – a tela está desligada.
PowerMonitorOn (1) – a tela está ligada.
PowerMonitorDim (2) – A tela está esmaecida.
Observação
Todos os aplicativos executados em uma sessão interativa no modo de usuário devem usar essa configuração. Quando os aplicativos do modo kernel se registram para monitorar o status, eles devem usar GUID_CONSOLE_DISPLAY_STATUS em vez disso.
GUID_SESSION_USER_PRESENCE (3C0F4548-C03F-4C4D-B9F2-237EDE686376)
O status do usuário associado à sessão do aplicativo foi alterado.
Windows 7, Windows Server 2008 R2, Windows Vista e Windows Server 2008: esta notificação está disponível a no Windows 8 e Windows Server 2012 e versões posteriores.
Essa notificação é enviada somente para aplicativos de modo de usuário em execução em uma sessão interativa. Os serviços e outros programas em execução na sessão 0 devem se registrar para GUID_GLOBAL_USER_PRESENCE.
O membro Data é um DWORD com um dos seguintes valores da enumeração USER_ACTIVITY_PRESENCE:
PowerUserPresent (0) – o usuário está fornecendo entrada para a sessão.
PowerUserInactive (2) – o tempo limite de atividade do usuário decorreu sem interação do usuário.
GUID_SYSTEM_AWAYMODE (98A7F580-01F7-48AA-9C0F-44352C29E5C0)
O sistema está entrando ou saindo do modo de afastamento.
O membro Data é um DWORD que indica o estado atual do modo de afastamento:
0x0 – o computador está saindo do modo de afastamento.
0x1 – o computador está entrando no modo de afastamento.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho |
|
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de