DPMSForceLevel(3) X FUNCTIONS 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)X Version 11 libXext 1.3.6 DPMSForceLevel(3)