hostdepend/X86MAC64/util/X86MAC64/cuda/doc/html/group__CUD3D9_ga7a31cc20f6c40f72705641f8d2d07f1.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
   3 <title>NVIDIA CUDA Library: cuD3D9ResourceGetMappedArray</title>
   4 <link href="customdoxygen.css" rel="stylesheet" type="text/css">
   5 <link href="tabs.css" rel="stylesheet" type="text/css">
   6 </head><body>
   7 <!-- Generated by Doxygen 1.5.8 -->
   8 <div class="navigation" id="top">
   9   <div class="tabs">
  10     <ul>
  11       <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
  12       <li><a href="modules.html"><span>Modules</span></a></li>
  13       <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
  14     </ul>
  15   </div>
  16 </div>
  17 <div class="contents">
  18   <div class="navpath"><a class="el" href="group__CUD3D9.html">Direct3D 9 Interoperability</a>
  19   </div>
  20 <table cellspacing="0" cellpadding="0" border="0">
  21   <tr>
  22    <td valign="top">
  23       <div class="navtab">
  24         <table>
  25           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_gc7e3bffad088b0d411cde87357592159.html#gc7e3bffad088b0d411cde87357592159">cuD3D9CtxCreate</a></td></tr>
  26           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_gd0581e5966aec0092db763a19026d7ed.html#gd0581e5966aec0092db763a19026d7ed">cuD3D9GetDevice</a></td></tr>
  27           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_gf62da531ff375cd96bdb4b1049da5e8c.html#gf62da531ff375cd96bdb4b1049da5e8c">cuD3D9GetDirect3DDevice</a></td></tr>
  28           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_g586d397787b364dfe3dcec650bad8e53.html#g586d397787b364dfe3dcec650bad8e53">cuD3D9MapResources</a></td></tr>
  29           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_g2b399afe8edf7c72871ab60f0d9bd326.html#g2b399afe8edf7c72871ab60f0d9bd326">cuD3D9RegisterResource</a></td></tr>
  30           <tr><td class="navtab"><a class="qindexHL" href="group__CUD3D9_ga7a31cc20f6c40f72705641f8d2d07f1.html#ga7a31cc20f6c40f72705641f8d2d07f1">cuD3D9ResourceGetMappedArray</a></td></tr>
  31           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_g133d04488a0dbde05359ecaab598beee.html#g133d04488a0dbde05359ecaab598beee">cuD3D9ResourceGetMappedPitch</a></td></tr>
  32           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_gbead7e07032dd90b15bc05e9c0a84fd1.html#gbead7e07032dd90b15bc05e9c0a84fd1">cuD3D9ResourceGetMappedPointer</a></td></tr>
  33           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_gdff025b4c0284a32a957be30e8156166.html#gdff025b4c0284a32a957be30e8156166">cuD3D9ResourceGetMappedSize</a></td></tr>
  34           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_ge18adaa2891cb7917f0e70a220a764e8.html#ge18adaa2891cb7917f0e70a220a764e8">cuD3D9ResourceGetSurfaceDimensions</a></td></tr>
  35           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_ga2f5c773dbb03bb6c4d6699bf70ce2c7.html#ga2f5c773dbb03bb6c4d6699bf70ce2c7">cuD3D9ResourceSetMapFlags</a></td></tr>
  36           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_gf62e9e411cbae04d12fce451a3a95221.html#gf62e9e411cbae04d12fce451a3a95221">cuD3D9UnmapResources</a></td></tr>
  37           <tr><td class="navtab"><a class="qindex" href="group__CUD3D9_g12e2ef50f8993a414d670a63773b6760.html#g12e2ef50f8993a414d670a63773b6760">cuD3D9UnregisterResource</a></td></tr>
  38         </table>
  39       </div>
  40    </td>
  41    <td valign="top">
  42 <a class="anchor" name="ga7a31cc20f6c40f72705641f8d2d07f1"></a><!-- doxytag: member="apidx9.c::cuD3D9ResourceGetMappedArray" ref="ga7a31cc20f6c40f72705641f8d2d07f1" args="(CUarray *pArray, IDirect3DResource9 *pResource, U32 face, U32 level)" -->
  43 <div class="memitem">
  44 <div class="memproto">
  45       <table class="memname">
  46         <tr>
  47           <td class="memname"><a class="el" href="group__CUDA__TYPES_g09da14df1a751dcbfeccb9cf0073d64c.html#g09da14df1a751dcbfeccb9cf0073d64c">CUresult</a> cuD3D9ResourceGetMappedArray           </td>
  48           <td>(</td>
  49           <td class="paramtype"><a class="el" href="group__CUDA__TYPES_gd550651524a56766b60f10f0e7628042.html#gd550651524a56766b60f10f0e7628042">CUarray</a> *&nbsp;</td>
  50           <td class="paramname"> <em>pArray</em>, </td>
  51         </tr>
  52         <tr>
  53           <td class="paramkey"></td>
  54           <td></td>
  55           <td class="paramtype">IDirect3DResource9 *&nbsp;</td>
  56           <td class="paramname"> <em>pResource</em>, </td>
  57         </tr>
  58         <tr>
  59           <td class="paramkey"></td>
  60           <td></td>
  61           <td class="paramtype">U32&nbsp;</td>
  62           <td class="paramname"> <em>face</em>, </td>
  63         </tr>
  64         <tr>
  65           <td class="paramkey"></td>
  66           <td></td>
  67           <td class="paramtype">U32&nbsp;</td>
  68           <td class="paramname"> <em>level</em></td><td>&nbsp;</td>
  69         </tr>
  70         <tr>
  71           <td></td>
  72           <td>)</td>
  73           <td></td><td></td><td></td>
  74         </tr>
  75       </table>
  76 </div>
  77 <div class="memdoc">
  78
  79 <p>
  80 Returns in <code>*pArray</code> an array through which the subresource of the mapped Direct3D resource <code>pResource</code> which corresponds to <code>face</code> and <code>level</code> may be accessed. The value set in <code>pArray</code> may change every time that <code>pResource</code> is mapped.<p>
  81 If <code>pResource</code> is not registered then <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaa0fd2e63260c6317ba943af0f7e4b8d21" title="Invalid handle.">CUDA_ERROR_INVALID_HANDLE</a> is returned. If <code>pResource</code> was not registered with usage flags CU_D3D9_REGISTER_FLAGS_ARRAY then <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaa0fd2e63260c6317ba943af0f7e4b8d21" title="Invalid handle.">CUDA_ERROR_INVALID_HANDLE</a> is returned. If <code>pResource</code> is not mapped then <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaae098433b926c9afdb6b6bdf191629447" title="Not mapped.">CUDA_ERROR_NOT_MAPPED</a> is returned.<p>
  82 For usage requirements of <code>face</code> and <code>level</code> parameters, see <a class="el" href="group__CUD3D9_gbead7e07032dd90b15bc05e9c0a84fd1.html#gbead7e07032dd90b15bc05e9c0a84fd1" title="Get the pointer through which to access a subresource of a Direct3D resource which...">cuD3D9ResourceGetMappedPointer()</a>.<p>
  83 <dl compact><dt><b>Parameters:</b></dt><dd>
  84   <table border="0" cellspacing="2" cellpadding="0">
  85     <tr><td valign="top"></td><td valign="top"><em>pArray</em>&nbsp;</td><td>- Returned array corresponding to subresource </td></tr>
  86     <tr><td valign="top"></td><td valign="top"><em>pResource</em>&nbsp;</td><td>- Mapped resource to access </td></tr>
  87     <tr><td valign="top"></td><td valign="top"><em>face</em>&nbsp;</td><td>- Face of resource to access </td></tr>
  88     <tr><td valign="top"></td><td valign="top"><em>level</em>&nbsp;</td><td>- Level of resource to access</td></tr>
  89   </table>
  90 </dl>
  91 <dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaaa0eed720f8a87cd1c5fd1c453bc7a03d" title="No errors.">CUDA_SUCCESS</a>, <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaaacf52f132faf29b473cdda6061f0f44a" title="Driver deinitialized.">CUDA_ERROR_DEINITIALIZED</a>, <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaa8feb999f0af99b4a25ab26b3866f4df8" title="Driver not initialized.">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaaa484e9af32c1e9893ff21f0e0191a12d" title="Invalid context.">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaa90696c86fcee1f536a1ec7d25867feeb" title="Invalid value.">CUDA_ERROR_INVALID_VALUE</a>, <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaa0fd2e63260c6317ba943af0f7e4b8d21" title="Invalid handle.">CUDA_ERROR_INVALID_HANDLE</a>, <a class="el" href="group__CUDA__TYPES_g0cdead942fd5028d157641eef6bdeeaa.html#gg0cdead942fd5028d157641eef6bdeeaae098433b926c9afdb6b6bdf191629447" title="Not mapped.">CUDA_ERROR_NOT_MAPPED</a> </dd></dl>
  92 <dl class="note" compact><dt><b>Note:</b></dt><dd>Note that this function may also return error codes from previous, asynchronous launches.</dd></dl>
  93 <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__CUD3D9_gc7e3bffad088b0d411cde87357592159.html#gc7e3bffad088b0d411cde87357592159" title="Create a CUDA context for interoperability with Direct3D.">cuD3D9CtxCreate</a>, <a class="el" href="group__CUD3D9_gd0581e5966aec0092db763a19026d7ed.html#gd0581e5966aec0092db763a19026d7ed" title="Gets the device number for an adapter.">cuD3D9GetDevice</a>, <a class="el" href="group__CUD3D9_gf62da531ff375cd96bdb4b1049da5e8c.html#gf62da531ff375cd96bdb4b1049da5e8c" title="Get the Direct3D device against which the current CUDA context was created.">cuD3D9GetDirect3DDevice</a>, <a class="el" href="group__CUD3D9_g586d397787b364dfe3dcec650bad8e53.html#g586d397787b364dfe3dcec650bad8e53" title="Map Direct3D resources for access by CUDA.">cuD3D9MapResources</a>, <a class="el" href="group__CUD3D9_g2b399afe8edf7c72871ab60f0d9bd326.html#g2b399afe8edf7c72871ab60f0d9bd326" title="Register a Direct3D resource for access by CUDA.">cuD3D9RegisterResource</a>, <a class="el" href="group__CUD3D9_g133d04488a0dbde05359ecaab598beee.html#g133d04488a0dbde05359ecaab598beee" title="Get the pitch of a subresource of a Direct3D resource which has been mapped for access...">cuD3D9ResourceGetMappedPitch</a>, <a class="el" href="group__CUD3D9_gbead7e07032dd90b15bc05e9c0a84fd1.html#gbead7e07032dd90b15bc05e9c0a84fd1" title="Get the pointer through which to access a subresource of a Direct3D resource which...">cuD3D9ResourceGetMappedPointer</a>, <a class="el" href="group__CUD3D9_gdff025b4c0284a32a957be30e8156166.html#gdff025b4c0284a32a957be30e8156166" title="Get the size of a subresource of a Direct3D resource which has been mapped for access...">cuD3D9ResourceGetMappedSize</a>, <a class="el" href="group__CUD3D9_ge18adaa2891cb7917f0e70a220a764e8.html#ge18adaa2891cb7917f0e70a220a764e8" title="Get the dimensions of a registered surface.">cuD3D9ResourceGetSurfaceDimensions</a>, <a class="el" href="group__CUD3D9_ga2f5c773dbb03bb6c4d6699bf70ce2c7.html#ga2f5c773dbb03bb6c4d6699bf70ce2c7" title="Set usage flags for mapping a Direct3D resource.">cuD3D9ResourceSetMapFlags</a>, <a class="el" href="group__CUD3D9_gf62e9e411cbae04d12fce451a3a95221.html#gf62e9e411cbae04d12fce451a3a95221" title="Unmaps Direct3D resources.">cuD3D9UnmapResources</a>, <a class="el" href="group__CUD3D9_g12e2ef50f8993a414d670a63773b6760.html#g12e2ef50f8993a414d670a63773b6760" title="Unregister a Direct3D resource.">cuD3D9UnregisterResource</a> </dd></dl>
  94
  95 </div>
  96 </div><p>
  97     </td>
  98   </tr>
  99 </table>
 100 </div>
 101 <hr size="1"><address style="text-align: right;"><small>
 102 Generated by Doxygen on Mon Mar 30 23:16:13 2009 for NVIDIA CUDA Library &nbsp;<a
 103 href="http://www.nvidia.com/cuda"><img src="nvidia_logo.jpg" alt="NVIDIA" align="middle" border="0" height="80"></a></small></address>
 104 </body>
 105 </html>