DPMSForceLevel(3) X Version 11 DPMSForceLevel(3)

# [NAME](#NAME)

DPMSForceLevel - forces a DPMS capable display into the specified power level

# [SYNOPSIS](#SYNOPSIS)

```
cc [ flag ... ] file ... -lXext [ library ... ]
#include <X11/extensions/dpms.h>

Status DPMSForceLevel ( Display *display, CARD16 level );
```

# [ARGUMENTS](#ARGUMENTS)

[*display*](#display)

Specifies the connection to the X server

[*level*](#level)

Specifies the level to force power to

# [DESCRIPTION](#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](#RETURN_VALUES)

[**TRUE**](#TRUE)

The *DPMSForceLevel* function always returns TRUE.

# [ERRORS](#ERRORS)

BadValue

A level other than **DPMSModeOn**, **DPMSModeStandby**, **DPMSModeSuspend**, or **DPMSModeOff** was specified.

BadMatch

DPMS is disabled on the specified display.

# [SEE ALSO](#SEE_ALSO)

[**DPMSCapable**(3)](/man/os/libxext/DPMSCapable.3), [**DPMSInfo**(3)](/man/os/libxext/DPMSInfo.3), [**DPMSGetTimeouts**(3)](/man/os/libxext/DPMSGetTimeouts.3), [**DPMSSetTimeouts**(3)](/man/os/libxext/DPMSSetTimeouts.3)

2005-06-28 libXext 1.3.7

---

Document: DPMSForceLevel(3) from libxext 1.3.7-r3 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libxext.git