DPMSForceLevel

Section: X FUNCTIONS (3)
Updated: libXext 1.3.4
Page Index
 

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)


 

Index

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO