NtSetThreadExecutionState - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
#ifndef _NTPOAPI_H
/**
* Enables an application to inform the system that it is in use,
* thereby preventing the system from entering sleep or turning off the display while the application is running.
*
* @param NewFlags New execution state flags.
* @param PreviousFlags Pointer to receive the previous execution state flags.
* @return Successful or errant status.
*/
NTSYSCALLAPI
NTSTATUS
NTAPI
NtSetThreadExecutionState(
_In_ EXECUTION_STATE NewFlags, // ES_* flags
_Out_ EXECUTION_STATE *PreviousFlags
);
View code on GitHub#ifndef _NTZWAPI_H
NTSYSCALLAPI
NTSTATUS
NTAPI
ZwSetThreadExecutionState(
_In_ EXECUTION_STATE NewFlags, // ES_* flags
_Out_ EXECUTION_STATE *PreviousFlags
);
View code on GitHubSets the execution state for the current thread and manages the corresponding power requests that prevent the system from dimming the display or entering sleep.
NewFlags - a bit mask containing flags thatPreviousFlags - a pointer to a variable that receives the previous execution state.ES_SYSTEM_REQUIRED - prevents the system from going to sleep.ES_DISPLAY_REQUIRED - forces the display to be on.ES_USER_PRESENT - this flag is not supported.ES_AWAYMODE_REQUIRED - enables the away mode that allows the computer appear to be sleeping while being active,ES_CONTINUOUS - the state should remain in effect until the next call that uses this flag.You can view the power requests created via this and other APIs via powercfg /requests.