DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

DPMSForceLevel(3)





NAME

       DPMSForceLevel - forces a DPMS capable display into the specified power
       level


SYNOPSIS

       cc [ flag ... ] file ... -lXext [ library ... ]
       #include <X11/extensions/dpms.h>

       Status DPMSForceLevel ( Display *display, CARD16 level );


ARGUMENTS

       display
              Specifies the connection to the X server

       level  Specifies the level to force power to


DESCRIPTION

       The DPMSForceLevel function forces a  DPMS  capable  display  into  the
       specified power level.  The level must be one of following four states:
       DPMSModeOn, DPMSModeStandby, DPMSModeSuspend,  or  DPMSModeOff.  Values
       other  than these will result in a BadValue error.  If DPMS is disabled
       on the display, trying to set the  power  level  on  the  display  will
       result in a BadMatch protocol error.


RETURN VALUES

       TRUE           The DPMSForceLevel function always returns TRUE.


ERRORS

       BadValue       A level other than DPMSModeOn, DPMSModeStandby, DPMSMod-
                      eSuspend, or DPMSModeOff was specified.

       BadMatch       DPMS is disabled on the specified display.


SEE ALSO

       DPMSCapable(3), DPMSInfo(3), DPMSGetTimeouts(3), DPMSSetTimeouts(3)

X Version 11                     libXext 1.0.3               DPMSForceLevel(3)

Man(1) output converted with man2html