1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>GX_SetVCount</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_SetVCount <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<PRE><CODE>#include &lt;nitro/gx/gx.h&gt;
20
21void GX_SetVCount(s32 count);<BR></CODE></PRE>
22  </dd>
23</dl><h2>Arguments</h2>
24<TABLE border="1" width="100%">
25  <TBODY>
26    <TR>
27      <TD width="289">count</TD>
28      <TD width="557">V count to set in the V-Counter (202 &le; <EM><STRONG><code>count</code></strong></em> &le; 211).</TD>
29    </TR>
30  </TBODY>
31</TABLE>
32<h2>Return Values</h2>
33<p>None.</p>
34<H2>Description</H2>
35<P>This function writes a value in the V-Count register. The written value takes effect when the V-Counter is updated. First, confirm that the current V count is between 202 and 211, then write that value between 202 and 211.<BR>However, because the V count cannot be set if line 212 has been reached while calling this function, to be sure this doesn't happen interrupts must be disabled and this function must called by line 210.</P>
36<P><FONT color="#ff3300">Caution: Because this could have a detrimental effect on the LCD, the following usage methods are prohibited.</FONT><UL>
37<LI>Advancing V-Count.
38<LI>Calling it twice or more in one frame.
39</UL></FONT></P>
40<P><FONT color="#ff3300">Because the synchronization of parent or child V blanking is thrown off if this function is used to set the V count during MP communications, do not use this function during MP communications as it will become impossible to stably perform communications in frame synchronous communication mode.</FONT></P>
41<h2>See Also</h2>
42<P><A href="GX_GetVCount.html">GX_GetVCount</A></P>
43<H2>Revision History</H2>
44<P>
452007/11/26 Changed warning notes.<br> 2007/10/16 Added restrictions during MP communications.<br>2007/01/26 Added warning notes.<br>2004/01/19 Initial version.</P>
46<hr><p>CONFIDENTIAL</p></body>
47</html>
48