OEMIdleEx (Compact 2013)

3/28/2014

This function places the CPUs in the idle state when there are no threads ready to run.

Syntax

void OEMIdleEx(LARGE_INTEGER *pliIdleTime);

Parameters

  • pliIdleTime
    [out] Pointer to the idle time in milliseconds; returns to the kernel the time spent in the idle state. The function updates this value based on the time the CPU enters the idle state, similar to the global variables curridlehigh and curridlelow, which are updated for a single-processor platform.

Return Value

None.

Remarks

You must implement this function to enable multiprocessor support if you have more than one CPU to handle per call to the CPUIdle function. If you implement the OEMIdleEx function, the kernel executes that function instead of OEMIdle. If you implement OEMIdleEx, set the pfnIdleEx member of OEMGLOBAL to point to this function.

When you update the OS scheduler's CurMSec value, only use the idle time for CPU 0.

Requirements

Header

oemglobal.h

Library

OEMMain.lib or OEMMain_StaticKITL.lib

See Also

Reference

SMP Functions