1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../css/manpage.css" type="text/css" />
7    <title>nngxGetInitializationCommand </title>
8  </head>
9  <body>
10    <h1><CODE>nngxGetInitializationCommand</CODE> Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14NNGX_APICALL GLsizei NNGX_APIENTRY nngxGetInitializationCommand(
15     GLsizei datasize,
16     GLvoid * data
17);
18</pre>
19    </div>
20    <h2>Parameters</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26            <th>Name</th>
27            <td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31          <td>in</td>
32          <th><CODE>datasize</CODE> </th>
33          <td>Byte size of the buffer indicated by <CODE>data</CODE>.</td>
34        </tr>
35        <tr>
36          <td>in</td>
37          <th><CODE>data</CODE> </th>
38          <td>Pointer to the buffer storing the command buffer.</td>
39        </tr> </table>
40    </div>
41    <h2>Return Values</h2>
42    <div class="section">Returns the byte size of the initialization commands. </div>
43    <h2>Description</h2>
44    <div class="section">
45      <p>Gets the register setting command for initializations that are executed with the <CODE>nngxInitialize</CODE> function.</p><P>
46                This function was added as a countermeasure for problems occurring related to rendering that occurs while returning from the HOME Menu or elsewhere when setting commands are directly created in registers without using the graphics library supported by the SDK. <BR />
47 Accordingly, there is normally no need to use this.            </P><P>
48                When <CODE>0</CODE> is specified for the <CODE>data</CODE> argument, no commands are obtained. <BR />Even when this function is called before initialization with the <a href="../nn_gx/nngxInitialize.html"><CODE>nngxInitialize</CODE></a> function, no commands are obtained (a return value of <CODE>0</CODE> is returned).
49            </P><P>
50                First, specify <CODE>0</CODE> in <CODE>data</CODE>, and call this function, get the size needed for command allocation as a return value, prepare a buffer of that size, and then call this function again.
51            </P><P>
52                This function generates the following errors.
53                <TABLE><TR><TH><CODE>GL_ERROR_80B4_DMP</CODE> </TH><TD>When <CODE>datasize</CODE> is smaller than the obtained command size.</TD></TR></TABLE></P></div>
54    <h2>See Also</h2>
55    <div class="section">
56      <p class="reference"><a href="../nn_gx/nngxInitialize.html"><CODE>nngxInitialize</CODE> </a><br /> </p>
57    </div>
58    <h2>Revision History</h2>
59    <div class="section">
60      <dl class="history">
61        <dt>2012/05/25</dt>
62        <dd>Initial version. <br />
63        </dd>
64      </dl>
65    </div>
66  <hr><p>CONFIDENTIAL</p></body>
67</html>