OEMMpCpuPowerFunc (Compact 2013)
3/28/2014
This function changes the power state of a specific CPU in a multiprocessor platform.
Syntax
BOOL OEMMpCpuPowerFunc(
DWORD dwProcessor,
BOOL fOnOff,
DWORD dwHint
);
Parameters
- dwProcessor
Hardware ID (CPU ID) of the processor to be turned on or off.
- fOnOff
Indicates whether to turn the processor on or off. The value true indicates on, and false indicates off.
- dwHint
A processor-specific hint that is passed to this function by the CePowerOffProcessor function. OEMMpCpuPowerFunc uses the dwHint value only when the processor is being turned off (fOnOff is set to false). This parameter is a hint to the OEM, and it can indicate whether to implement a partial power-down or a full shutdown. A value of 1 indicates full shutdown, and other values are implementation-specific.
Return Value
Returns true if successful; otherwise, returns false.
Remarks
This function is optional for multiprocessor support. You should implement it if your hardware platform supports turning off secondary CPUs to save power. If you implement OEMMpCpuPowerFunc, set the pfnMpCpuPowerFunc member of OEMGLOBAL to point to this function.
Do not call this function directly in your OAL. The kernel must maintain control of which CPUs are powered. Use the CePowerOnProcessor and CePowerOffProcessor functions to control which CPUs are powered.
Requirements
Header |
oemglobal.h |
Library |
OEMMain.lib or OEMMain_StaticKITL.lib |