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

libXext 1.3.7 2005-06-28 DPMSForceLevel(3)