PowerMgr.h

Go to the documentation of this file.

/************************************************
*
*  CROSSCONTROL AUX API
*
*  PowerMgr.h
*
*  Version 2.17.0.0", 2019-10-22
*
*  (c) CrossControl 2010-2019
*

 *  File description: 
 *  Access functions for managing application shutdown/cleanup 
 *  when suspend or shutdown events occur. An application can use this framework 
 *  to delay a suspend/shutdown until it is ready with any tasks it needs to do.
 *  It is also possible to use existing OS functions to achieve the same result.
 *
 *  Note that applications should not use these functions to delay a suspend/shutdown 
 *  request for a long time (up to 20s may be okay). The computer will eventually 
 *  be shut down forcibly if the application does not respond. 
 *
 *  It is not recommended for multiple applications to access the PowerMgr
 *  functionality simultaneously, although it is supported on some platforms.
 *
 *  Note that a shutdown initiated by the OS will not be caught by this framework. 
 *
 *  Example Usage:
 *  @include powermgr_example.cpp
 *
 ************************************************/

#ifndef CC_POWERMGR_H_
#define CC_POWERMGR_H_

#include "CCAuxErrors.h"
#include "CCAuxTypes.h"
#include "CCPlatform.h"

#ifdef __cplusplus
namespace CrossControl
{
#endif

  typedef enum
  {
    Normal = 0,

    ApplicationControlled = 1, 

    BatterySuspend = 2
  } PowerMgrConf;

  typedef enum 
  {
    NoRequestsPending = 0,
    SuspendPending = 1,
    ShutdownPending = 2
  }PowerMgrStatus;

  typedef void* POWERMGRHANDLE;

  EXTERN_C
    CCAUXDLL_API
    POWERMGRHANDLE
    CCAUXDLL_CALLING_CONV
    GetPowerMgr(void);

  EXTERN_C
    CCAUXDLL_API
    void
    CCAUXDLL_CALLING_CONV
    PowerMgr_release(POWERMGRHANDLE);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PowerMgr_registerControlledSuspendOrShutDown(POWERMGRHANDLE, PowerMgrConf conf);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PowerMgr_getConfiguration(POWERMGRHANDLE, PowerMgrConf* conf);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PowerMgr_getPowerMgrStatus(POWERMGRHANDLE, PowerMgrStatus* status);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PowerMgr_setAppReadyForSuspendOrShutdown(POWERMGRHANDLE);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PowerMgr_hasResumed(POWERMGRHANDLE, bool* resumed);

#ifdef __cplusplus
}
#endif

#endif /* CC_POWERMGR_H_ */