---
name: "DPMSForceLevel"
section: "3x"
platform: "linux"
package: "libxext-dev"
version: "1:1.0.1-2"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/DPMSForceLevel/3x"
---

# DPMSForceLevel(3x)

forces a DPMS capable display into the specified power level

## 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**(3x)](/DPMSCapable/3x.md), [**DPMSInfo**(3x)](/DPMSInfo/3x.md), [**DPMSGetTimeouts**(3x)](/DPMSGetTimeouts/3x.md), [**DPMSSetTimeouts**(3x)](/DPMSSetTimeouts/3x.md)