PMExt_PMBeforeNewDeviceState (Compact 2013)
3/26/2014
This function is called by Power Manager to indicate that a device is about to enter a new power state.
Syntax
VOID PMExt_PMBeforeNewDeviceState{
DWORD dwExtContext,
LPCTSTR lpNewStateName,
CEDEVICE_POWER_STATE curDx,
CEDEVICE_POWER_STATE reqDx
};
Parameters
- dwExtContext
[in] Context value returned after PME initialization by PMExt_Init.
- lpNewStateName
[in] Names the pending device power state..
- curDx
[in] A value of type CEDEVICE_POWER_STATE describing the current device power state.
- reqDx
[in] A value of type CEDEVICE_POWER_STATE describing the requested device power state.
Return Value
None.
Remarks
This callback is used by Power Manager to indicate that a device is about to enter a new power state. The Power Management Extension (PME) can act upon this call perform any desired actions before the device transitions to the specified power state.
Warning
Power Management Extensions execute within the context of the core Power Manager, and can have a significant effect on overall system performance and security. Errors in a PME can block the core Power Manager thread indefinitely; this can cause the system to stop responding. Performance issues in a PME can harm overall system performance. Security vulnerabilities in a PME can increase a system's vulnerability to malicious attacks.
Requirements
Header |
Pmext.h |