Share via


SystemIdleTimerReset (Windows Embedded CE 6.0)

1/6/2010

This function resets a system timer that controls whether or not the device will automatically go into a suspended state.

Syntax

void WINAPI SystemIdleTimerReset(void); 

Parameters

None.

Return Value

None.

Remarks

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.

If the Power Manager is managing timeouts, calls to SystemIdleTimerReset will still reset the GWES timeout and cause the screen saver to stop showing.

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

Requirements

Header winuser.h
Windows Embedded CE Windows CE 2.0 and later

See Also

Reference

Windows Timer Functions