This function resets a system timer that controls whether or not the device will automatically go into a suspended state.
At a Glance
| Header file: | Winuser.h |
| Windows CE versions: | 2.0 and later |
Syntax
void WINAPI SystemIdleTimerReset( void);
Return Values
None.
Remarks
In Windows CE, the default behavior is to go into a suspended state after a specified period of time expires. This time interval is specified in the registry. Calling SystemIdleTimerReset overrides the registry setting by resetting the timer.
This function must be use appropriately. On battery powered devices, a program that never suspends (or sleeps) by continually calling SystemIdleTimerReset can quickly drain the batteries.
The frequency in which to call SystemIdleTimerReset in order to keep a device awake can be determined retrieving the following registry key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Power