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>MapTexture2DResource</title>
8  </head>
9  <body>
10    <h1><CODE>nn::gd::CTR::Resource::MapTexture2DResource</CODE> Member Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14static <a href="../../../../nnResult/Overview.html">nnResult</a> MapTexture2DResource(
15     Texture2DResource * texture2DResource,
16     s32 mipLevelIndex,
17     <a href="../../../../nn/gd/CTR/Resource/MapUsage.html">MapUsage</a> usage,
18     void ** data
19);
20</pre>
21    </div>
22    <h2>Arguments</h2>
23    <div class="section">
24      <table class="arguments">
25        <thead>
26          <tr>
27            <td width="15" />
28            <th>Name</th>
29            <td>Description</td>
30          </tr>
31        </thead>
32        <tr>
33          <td>in</td>
34          <th>texture2DResource</th>
35          <td>Specifies the pointer to the 2D texture resource for the data pointer being obtained.</td>
36        </tr>
37        <tr>
38          <td>in</td>
39          <th>mipLevelIndex</th>
40          <td>Specifies the pointer to the mipmap level index for the data pointer being obtained. If -1 is specified, the last mipmap level is used.</td>
41        </tr>
42        <tr>
43          <td>in</td>
44          <th>usage</th>
45          <td>Specifies how the resource is to be used.</td>
46        </tr>
47        <tr>
48          <td>out</td>
49          <th><CODE>data</CODE></th>
50          <td>Specifies the address for storing the pointer to the obtained data.</td>
51        </tr> </table>
52    </div>
53    <h2>Return Values</h2>
54    <div class="section">Returns the result of the operation. <br />
55      <table class="arguments">
56        <thead>
57          <tr>
58            <th>Value</th>
59            <td>Description</td>
60          </tr>
61        </thead>
62        <tr>
63          <th><CODE>ResultSuccess</CODE></th>
64          <td>Process was successful.</td>
65        </tr>
66        <tr>
67          <th>ResultNullParameter</th>
68          <td><CODE>NULL </CODE>was specified for either <B>texture2DResource </B>or <B>data</B>.</td>
69        </tr>
70        <tr>
71          <th>ResultInvalidMemoryRegion</th>
72          <td>Either the resource memory type or the usage method is invalid. It might be that an attempt was made by MAP_WRITE_ONLY or MAP_READ_WRITE to get a memory region that was allocated to VRAM.</td>
73        </tr>
74        <tr>
75          <th>ResultInvalidTextureMipLevelIndex</th>
76          <td><CODE>mipLevelIndex</CODE> is invalid.</td>
77        </tr>
78      </table> </div>
79    <h2>Description</h2>
80    <div class="section">
81      <p>Obtains a data pointer for the specified resource.</p><!-- write here --></div>
82    <h2>Revision History</h2>
83    <div class="section">
84      <dl class="history">
85        <dt>2011/02/17</dt>
86        <dd>Initial version.<br />
87        </dd>
88      </dl>
89    </div>
90  <hr><p>CONFIDENTIAL</p></body>
91</html>