NAME

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

SYNOPSIS


cccc [ _f_l_a_g ... ] _f_i_l_e ... -llXXeexxtt [ _l_i_b_r_a_r_y ... ]
#include 
Status DPMSForceLevel ( Display _*_d_i_s_p_l_a_y, CARD16 _l_e_v_e_l );
     

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 _l_e_v_e_l 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)