RequestWakeupLatency function

[RequestWakeupLatency is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Has no effect and returns STATUS_NOT_SUPPORTED. This function is provided only for compatibility with earlier versions of Windows.

Windows Server 2008 and Windows Vista:  Has no effect and always returns success.

Syntax


BOOL WINAPI RequestWakeupLatency(
  _In_ LATENCY_TIME latency
);

Parameters

latency [in]

The latency requirement for the time is takes to wake the computer. This parameter can be one of the following values.

ValueMeaning
LT_LOWEST_LATENCY
1

PowerSystemSleeping1 state (equivalent to ACPI state S0 and APM state Working).

LT_DONT_CARE
0

Any latency (default).

 

Return value

The return value is nonzero.

Remarks

The system uses the wake-up latency requirement when choosing a sleeping state. The latency is not guaranteed because wake-up time is determined by the hardware design of the particular computer.

To cancel a latency request, call RequestWakeupLatency with LT_DONT_CARE.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Power Management Functions

 

 

Show: