| DPMSForceLevel(3) | Library Functions Manual | 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, DPMSModeSuspend, or DPMSModeOff was specified.
- 
BadMatch
- 
DPMS is disabled on the specified display.
 
SEE ALSO
 DPMSCapable(3), DPMSInfo(3), DPMSGetTimeouts(3), DPMSSetTimeouts(3)