1DPMSForceLevel(3)                 X FUNCTIONS                DPMSForceLevel(3)
2
3
4

NAME

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

SYNOPSIS

10       cc [ flag ... ] file ... -lXext [ library ... ]
11       #include <X11/extensions/dpms.h>
12
13       Status DPMSForceLevel ( Display *display, CARD16 level );
14

ARGUMENTS

16       display
17              Specifies the connection to the X server
18
19       level  Specifies the level to force power to
20

DESCRIPTION

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

RETURN VALUES

30       TRUE           The DPMSForceLevel function always returns TRUE.
31

ERRORS

33       BadValue       A level other than DPMSModeOn, DPMSModeStandby, DPMSMod‐
34                      eSuspend, or DPMSModeOff was specified.
35
36       BadMatch       DPMS is disabled on the specified display.
37

SEE ALSO

39       DPMSCapable(3), DPMSInfo(3), DPMSGetTimeouts(3), DPMSSetTimeouts(3)
40
41
42
43X Version 11                     libXext 1.3.5               DPMSForceLevel(3)