DPMSForceLevel (3)

Forces a dpms capable display into the specified power level

  1. Carta.tech
  2. Man Pages
  3. Library calls
  4. DPMSForceLevel: Forces a dpms capable display into the specified power level
  1. Carta.tech
  2. Packages
  3. libxext-dev
  4. 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.

RELATED TO DPMSForceLevel…

DPMSCapable(3), DPMSInfo(3), DPMSGetTimeouts(3), DPMSSetTimeouts(3)