Partager via

PMExt_PMBeforeNewDeviceState (Compact 2013)

  • Article

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..

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

See Also

Reference

Power Management Functions
CEDEVICE_POWER_STATE