DPMSForceLevel(3xext) X FUNCTIONS DPMSForceLevel(3xext)NAMEDPMSForceLevel - forces a DPMS capable display into the specified power
level
SYNOPSIS
cc [ flag... ] file... -lXext [ library... ]
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 ALSODPMSCapable(3xext), DPMSInfo(3xext), DPMSGetTimeouts(3xext), DPMSSet‐
Timeouts(3xext)ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │x11/library/libxext │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │See XInitThreads(3X11) │
└─────────────────────────────┴─────────────────────────────┘
X Version 11 libXext 1.1.2 DPMSForceLevel(3xext)