SetSystemPowerState
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função define o estado de energia sistema para o valor solicitado.
Syntax
DWORD SetSystemPowerState(
LPCWSTR psState,
DWORD StateFlags,
DWORD Options
);
Parameters
- psState
[no] O estado sistema desejado para inserir nomes. Se este parâmetro não for NULL, o StateFlags parâmetro será ignorado.
StateFlags
[no] Opcional. Se a pasta psState parâmetro é NULL, ele nomeia o estado de energia sistema usando o POWER_STATE_XXX Sinalizadores definidos no arquivo de cabeçalho PM.h.For Windows Embedded CE: A seguinte tabela mostra os valores possíveis.
Sinalizador Descrição POWER_STATE_BOOT
Inicialize estado.
POWER_STATE_CRITICAL
Estado crítico.
POWER_STATE_IDLE
Estado ocioso.
POWER_STATE_OFF
Desativar estado.
POWER_STATE_ON
No estado.
POWER_STATE_PASSWORD
Estado de energia protegido por senha.
POWER_STATE_RESET
Estado Redefinir.
POWER_STATE_SUSPEND
Estado suspenso.
- Opções
[no] Usa o opcional POWER_FORCE sinalizador para indicar que o estado transferir é urgente. A interpretação desse sinalizador é plataforma-dependente.
Return Value
- ERROR_SUCCESS
Indica que o estado de energia sistema foi definido com êxito.
- Código de erro Win32
Indica que o estado de energia sistema não foi definido.
Remarks
.gif)
Para todas as plataformas
Se o estado de energia solicitada transição faz com que o sistema para ser suspenso, essa função retorna somente depois de sistema operação currículos e relacionado PBT_RESUME mensagens foram transmitir in a POWER_BROADCAST estrutura. Algumas plataformas podem restringir qual energia sistema estados podem ser definidos por aplicativos.
Estados de energia do sistema definir níveis de energia máxima dispositivo para todos os dispositivos gerenciável energia no sistema. Se um dispositivo já estiver em ou abaixo de energia máxima nível obrigadas pelo estado de energia novo sistema, o estado de energia dispositivo não é atualizado.
Se um sistema chamar explicitamente coloca o dispositivo em um ocioso estado, um apropriado Wake origem evento deve ser implementado no dispositivo de destino para ativar o dispositivo quando um aplicativo chama SetSystemPowerState(POWER_STATE_SUSPEND). **
Para Mobile Windows
O sinalizador POWER_STATE_IDLE para a StateFlags parâmetro está definido como Tela logoff para dispositivos Windows Mobile powered. Em additon, o StateFlags parâmetro também pode ser definido para o estado POWER_STATE_USERIDLE para dispositivos Windows Mobile powered.
O Opções parâmetro pode ser definido como POWER_DUMPDW para gerar um Dr.. Relatório de erro Watson.