man-pages/man3/DPMSForceLevel.3.html
2021-03-31 01:06:50 +01:00

106 lines
2.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of DPMSForceLevel</TITLE>
</HEAD><BODY>
<H1>DPMSForceLevel</H1>
Section: X FUNCTIONS (3)<BR>Updated: libXext 1.3.4<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
DPMSForceLevel - forces a DPMS capable display into the
specified power level
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<P>
<PRE>
<B>cc</B> [ <I>flag</I> ... ] <I>file</I> ... -<B>lXext</B> [ <I>library</I> ... ]
#include &lt;<A HREF="file:///usr/include/X11/extensions/dpms.h">X11/extensions/dpms.h</A>&gt;
<DL COMPACT>
<DT id="1"><B>Status DPMSForceLevel</B> ( Display <I>*display</I>, CARD16 <I>level</I> );
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</DL>
</PRE><A NAME="lbAD">&nbsp;</A>
<H2>ARGUMENTS</H2>
<DL COMPACT>
<DT id="2"><I>display</I>
<DD>
<DD>Specifies the connection to the X server
<DT id="3"><I>level</I>
<DD>
Specifies the level to force power to
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
The
<I>DPMSForceLevel</I>
function forces a DPMS capable display into the specified power level. The
<I>level</I> 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.
<A NAME="lbAF">&nbsp;</A>
<H2>RETURN VALUES</H2>
<DL COMPACT>
<DT id="4">TRUE<DD>
The
<I>DPMSForceLevel</I>
function always returns TRUE.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>ERRORS</H2>
<DL COMPACT>
<DT id="5">BadValue<DD>
A level other than DPMSModeOn, DPMSModeStandby, DPMSModeSuspend, or DPMSModeOff
was specified.
<DT id="6"><FONT SIZE="-1">BadMatch</FONT>
<DD>
DPMS is disabled on the specified display.
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?3+DPMSCapable">DPMSCapable</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?3+DPMSInfo">DPMSInfo</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?3+DPMSGetTimeouts">DPMSGetTimeouts</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?3+DPMSSetTimeouts">DPMSSetTimeouts</A></B>(3)
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">ARGUMENTS</A><DD>
<DT id="10"><A HREF="#lbAE">DESCRIPTION</A><DD>
<DT id="11"><A HREF="#lbAF">RETURN VALUES</A><DD>
<DT id="12"><A HREF="#lbAG">ERRORS</A><DD>
<DT id="13"><A HREF="#lbAH">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:39 GMT, March 31, 2021
</BODY>
</HTML>