hostdepend/X86MAC64/util/X86MAC64/cuda/doc/html/group__CUDART__MEMORY_ga37909c2448136db5829682d49bce8d9.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: cudaMemcpyArrayToArray</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__CUDART__MEMORY.html">Memory Management</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__CUDART__MEMORY_gb17fef862d4d1fefb9dba35bd62a187e.html#gb17fef862d4d1fefb9dba35bd62a187e">cudaFree</a></td></tr>
  26           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g87eb9f7a50c1f43aee18bdcfde3f4340.html#g87eb9f7a50c1f43aee18bdcfde3f4340">cudaFreeArray</a></td></tr>
  27           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_gedaeb2708ad3f74d5b417ee1874ec84a.html#gedaeb2708ad3f74d5b417ee1874ec84a">cudaFreeHost</a></td></tr>
  28           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g2db2376f8fb4203df2fa9e104e16978e.html#g2db2376f8fb4203df2fa9e104e16978e">cudaGetSymbolAddress</a></td></tr>
  29           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g8423ddbee69126e5507178f1567b05f1.html#g8423ddbee69126e5507178f1567b05f1">cudaGetSymbolSize</a></td></tr>
  30           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g217d441a73d9304c6f0ccc22ec307dba.html#g217d441a73d9304c6f0ccc22ec307dba">cudaHostAlloc</a></td></tr>
  31           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_ga475419a9b21a66036029d5001ea908c.html#ga475419a9b21a66036029d5001ea908c">cudaHostGetDevicePointer</a></td></tr>
  32           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_gc63ffd93e344b939d6399199d8b12fef.html#gc63ffd93e344b939d6399199d8b12fef">cudaMalloc</a></td></tr>
  33           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g04a7553c90322aef32f8544d5c356a10.html#g04a7553c90322aef32f8544d5c356a10">cudaMalloc3D</a></td></tr>
  34           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g44aff09d5db8b6fa81bd0576d8131da3.html#g44aff09d5db8b6fa81bd0576d8131da3">cudaMalloc3DArray</a></td></tr>
  35           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_ge56101fe6f1ce0b48f163632f6862ae4.html#ge56101fe6f1ce0b48f163632f6862ae4">cudaMallocArray</a></td></tr>
  36           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g9f93d9600f4504e0d637ceb43c91ebad.html#g9f93d9600f4504e0d637ceb43c91ebad">cudaMallocHost</a></td></tr>
  37           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g80d689bc903792f906e49be4a0b6d8db.html#g80d689bc903792f906e49be4a0b6d8db">cudaMallocPitch</a></td></tr>
  38           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g48efa06b81cc031b2aa6fdc2e9930741.html#g48efa06b81cc031b2aa6fdc2e9930741">cudaMemcpy</a></td></tr>
  39           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g17f3a55e8c9aef5f90b67cdf22851375.html#g17f3a55e8c9aef5f90b67cdf22851375">cudaMemcpy2D</a></td></tr>
  40           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_gd961f35704f81aa8d16f68707897c150.html#gd961f35704f81aa8d16f68707897c150">cudaMemcpy2DArrayToArray</a></td></tr>
  41           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g30c6e66c873a7e53a649f96b54b09465.html#g30c6e66c873a7e53a649f96b54b09465">cudaMemcpy2DAsync</a></td></tr>
  42           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g96eddd33b321e91d6fb1b9f337bf5a47.html#g96eddd33b321e91d6fb1b9f337bf5a47">cudaMemcpy2DFromArray</a></td></tr>
  43           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_gad2e62119c537b9780b83a36d79340c6.html#gad2e62119c537b9780b83a36d79340c6">cudaMemcpy2DFromArrayAsync</a></td></tr>
  44           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g1cc6e4eb2a5e0cd2bebbc8ebb4b6c46f.html#g1cc6e4eb2a5e0cd2bebbc8ebb4b6c46f">cudaMemcpy2DToArray</a></td></tr>
  45           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_ga0c91838976fe1d33014bd21bb9307bb.html#ga0c91838976fe1d33014bd21bb9307bb">cudaMemcpy2DToArrayAsync</a></td></tr>
  46           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_gc1372614eb614f4689fbb82b4692d30a.html#gc1372614eb614f4689fbb82b4692d30a">cudaMemcpy3D</a></td></tr>
  47           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g5a8927bf1ea5de8c003316c9fd68d63b.html#g5a8927bf1ea5de8c003316c9fd68d63b">cudaMemcpy3DAsync</a></td></tr>
  48           <tr><td class="navtab"><a class="qindexHL" href="group__CUDART__MEMORY_ga37909c2448136db5829682d49bce8d9.html#ga37909c2448136db5829682d49bce8d9">cudaMemcpyArrayToArray</a></td></tr>
  49           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_ge4366f68c6fa8c85141448f187d2aa13.html#ge4366f68c6fa8c85141448f187d2aa13">cudaMemcpyAsync</a></td></tr>
  50           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g1620c76fb3337df8dc7186fd88f40b1a.html#g1620c76fb3337df8dc7186fd88f40b1a">cudaMemcpyFromArray</a></td></tr>
  51           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g6759d51be63c55ecf65f95fe41812f99.html#g6759d51be63c55ecf65f95fe41812f99">cudaMemcpyFromArrayAsync</a></td></tr>
  52           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g0b2cb4468ec7529fe24722f30e831a24.html#g0b2cb4468ec7529fe24722f30e831a24">cudaMemcpyFromSymbol</a></td></tr>
  53           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_gd714c659cb7b652fac87cb3ccdabd709.html#gd714c659cb7b652fac87cb3ccdabd709">cudaMemcpyFromSymbolAsync</a></td></tr>
  54           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g06db36948e3ccda65d1adf3529420696.html#g06db36948e3ccda65d1adf3529420696">cudaMemcpyToArray</a></td></tr>
  55           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g8e6d82b24a4482ed49ba242fd231a9a5.html#g8e6d82b24a4482ed49ba242fd231a9a5">cudaMemcpyToArrayAsync</a></td></tr>
  56           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g58acd070e6f9bb82d7aeee3d0b958460.html#g58acd070e6f9bb82d7aeee3d0b958460">cudaMemcpyToSymbol</a></td></tr>
  57           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g981a3eb36f49cd65e69eb575739ba5d7.html#g981a3eb36f49cd65e69eb575739ba5d7">cudaMemcpyToSymbolAsync</a></td></tr>
  58           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_ge07c97b96efd09abaeb3ca3b5f8da4ee.html#ge07c97b96efd09abaeb3ca3b5f8da4ee">cudaMemset</a></td></tr>
  59           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g2b3248e96aaba2241796e113d1798db3.html#g2b3248e96aaba2241796e113d1798db3">cudaMemset2D</a></td></tr>
  60           <tr><td class="navtab"><a class="qindex" href="group__CUDART__MEMORY_g35171e821992f71d3c50f17032e079dc.html#g35171e821992f71d3c50f17032e079dc">cudaMemset3D</a></td></tr>
  61         </table>
  62       </div>
  63    </td>
  64    <td valign="top">
  65 <a class="anchor" name="ga37909c2448136db5829682d49bce8d9"></a><!-- doxytag: member="cuda_runtime_api.cpp::cudaMemcpyArrayToArray" ref="ga37909c2448136db5829682d49bce8d9" args="(struct cudaArray *dst, size_t wOffsetDst, size_t hOffsetDst, const struct cudaArray *src, size_t wOffsetSrc, size_t hOffsetSrc, size_t count, enum cudaMemcpyKind kind)" -->
  66 <div class="memitem">
  67 <div class="memproto">
  68       <table class="memname">
  69         <tr>
  70           <td class="memname"><a class="el" href="group__CUDART__TYPES_gf599e5b8b829ce7db0f5216928f6ecb6.html#gf599e5b8b829ce7db0f5216928f6ecb6">cudaError_t</a> cudaMemcpyArrayToArray           </td>
  71           <td>(</td>
  72           <td class="paramtype">struct cudaArray *&nbsp;</td>
  73           <td class="paramname"> <em>dst</em>, </td>
  74         </tr>
  75         <tr>
  76           <td class="paramkey"></td>
  77           <td></td>
  78           <td class="paramtype">size_t&nbsp;</td>
  79           <td class="paramname"> <em>wOffsetDst</em>, </td>
  80         </tr>
  81         <tr>
  82           <td class="paramkey"></td>
  83           <td></td>
  84           <td class="paramtype">size_t&nbsp;</td>
  85           <td class="paramname"> <em>hOffsetDst</em>, </td>
  86         </tr>
  87         <tr>
  88           <td class="paramkey"></td>
  89           <td></td>
  90           <td class="paramtype">const struct cudaArray *&nbsp;</td>
  91           <td class="paramname"> <em>src</em>, </td>
  92         </tr>
  93         <tr>
  94           <td class="paramkey"></td>
  95           <td></td>
  96           <td class="paramtype">size_t&nbsp;</td>
  97           <td class="paramname"> <em>wOffsetSrc</em>, </td>
  98         </tr>
  99         <tr>
 100           <td class="paramkey"></td>
 101           <td></td>
 102           <td class="paramtype">size_t&nbsp;</td>
 103           <td class="paramname"> <em>hOffsetSrc</em>, </td>
 104         </tr>
 105         <tr>
 106           <td class="paramkey"></td>
 107           <td></td>
 108           <td class="paramtype">size_t&nbsp;</td>
 109           <td class="paramname"> <em>count</em>, </td>
 110         </tr>
 111         <tr>
 112           <td class="paramkey"></td>
 113           <td></td>
 114           <td class="paramtype">enum <a class="el" href="group__CUDART__TYPES_g18fa99055ee694244a270e4d5101e95b.html#g18fa99055ee694244a270e4d5101e95b">cudaMemcpyKind</a>&nbsp;</td>
 115           <td class="paramname"> <em>kind</em></td><td>&nbsp;</td>
 116         </tr>
 117         <tr>
 118           <td></td>
 119           <td>)</td>
 120           <td></td><td></td><td></td>
 121         </tr>
 122       </table>
 123 </div>
 124 <div class="memdoc">
 125
 126 <p>
 127 Copies <code>count</code> bytes from the CUDA array <code>src</code> starting at the upper left corner (<code>wOffsetSrc</code>, <code>hOffsetSrc</code>) to the CUDA array <code>dst</code> starting at the upper left corner (<code>wOffsetDst</code>, <code>hOffsetDst</code>) where <code>kind</code> is one of <a class="el" href="group__CUDART__TYPES_g18fa99055ee694244a270e4d5101e95b.html#gg18fa99055ee694244a270e4d5101e95bdeec295de8a74ac2a74f98ffb6c5d7c7" title="Host -&gt; Host.">cudaMemcpyHostToHost</a>, <a class="el" href="group__CUDART__TYPES_g18fa99055ee694244a270e4d5101e95b.html#gg18fa99055ee694244a270e4d5101e95b1a03d03a676ea8ec51b9b1e193617568" title="Host -&gt; Device.">cudaMemcpyHostToDevice</a>, <a class="el" href="group__CUDART__TYPES_g18fa99055ee694244a270e4d5101e95b.html#gg18fa99055ee694244a270e4d5101e95b5653197602d3455a530db5a7edb1a253" title="Device -&gt; Host.">cudaMemcpyDeviceToHost</a>, or <a class="el" href="group__CUDART__TYPES_g18fa99055ee694244a270e4d5101e95b.html#gg18fa99055ee694244a270e4d5101e95b783338534304281650c6cb1363f5a00a" title="Device -&gt; Device.">cudaMemcpyDeviceToDevice</a>, and specifies the direction of the copy.<p>
 128 <dl compact><dt><b>Parameters:</b></dt><dd>
 129   <table border="0" cellspacing="2" cellpadding="0">
 130     <tr><td valign="top"></td><td valign="top"><em>dst</em>&nbsp;</td><td>- Destination memory address </td></tr>
 131     <tr><td valign="top"></td><td valign="top"><em>wOffsetDst</em>&nbsp;</td><td>- Destination starting X offset </td></tr>
 132     <tr><td valign="top"></td><td valign="top"><em>hOffsetDst</em>&nbsp;</td><td>- Destination starting Y offset </td></tr>
 133     <tr><td valign="top"></td><td valign="top"><em>src</em>&nbsp;</td><td>- Source memory address </td></tr>
 134     <tr><td valign="top"></td><td valign="top"><em>wOffsetSrc</em>&nbsp;</td><td>- Source starting X offset </td></tr>
 135     <tr><td valign="top"></td><td valign="top"><em>hOffsetSrc</em>&nbsp;</td><td>- Source starting Y offset </td></tr>
 136     <tr><td valign="top"></td><td valign="top"><em>count</em>&nbsp;</td><td>- Size in bytes to copy </td></tr>
 137     <tr><td valign="top"></td><td valign="top"><em>kind</em>&nbsp;</td><td>- Type of transfer</td></tr>
 138   </table>
 139 </dl>
 140 <dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="group__CUDART__TYPES_g3f51e3575c2178246db0a94a430e0038.html#gg3f51e3575c2178246db0a94a430e0038e355f04607d824883b4a50662830d591" title="No errors.">cudaSuccess</a>, <a class="el" href="group__CUDART__TYPES_g3f51e3575c2178246db0a94a430e0038.html#gg3f51e3575c2178246db0a94a430e00383e8aef5398ee38e28ed41e357b48917c" title="Invalid value.">cudaErrorInvalidValue</a>, <a class="el" href="group__CUDART__TYPES_g3f51e3575c2178246db0a94a430e0038.html#gg3f51e3575c2178246db0a94a430e003872ce39cee8ef48a83b0191b2e33d2630" title="Invalid memcpy direction.">cudaErrorInvalidMemcpyDirection</a> </dd></dl>
 141 <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>
 142 <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__CUDART__MEMORY_g48efa06b81cc031b2aa6fdc2e9930741.html#g48efa06b81cc031b2aa6fdc2e9930741" title="Copies data between host and device.">cudaMemcpy</a>, <a class="el" href="group__CUDART__MEMORY_g17f3a55e8c9aef5f90b67cdf22851375.html#g17f3a55e8c9aef5f90b67cdf22851375" title="Copies data between host and device.">cudaMemcpy2D</a>, <a class="el" href="group__CUDART__MEMORY_g06db36948e3ccda65d1adf3529420696.html#g06db36948e3ccda65d1adf3529420696" title="Copies data between host and device.">cudaMemcpyToArray</a>, <a class="el" href="group__CUDART__MEMORY_g1cc6e4eb2a5e0cd2bebbc8ebb4b6c46f.html#g1cc6e4eb2a5e0cd2bebbc8ebb4b6c46f" title="Copies data between host and device.">cudaMemcpy2DToArray</a>, <a class="el" href="group__CUDART__MEMORY_g1620c76fb3337df8dc7186fd88f40b1a.html#g1620c76fb3337df8dc7186fd88f40b1a" title="Copies data between host and device.">cudaMemcpyFromArray</a>, <a class="el" href="group__CUDART__MEMORY_g96eddd33b321e91d6fb1b9f337bf5a47.html#g96eddd33b321e91d6fb1b9f337bf5a47" title="Copies data between host and device.">cudaMemcpy2DFromArray</a>, <a class="el" href="group__CUDART__MEMORY_gd961f35704f81aa8d16f68707897c150.html#gd961f35704f81aa8d16f68707897c150" title="Copies data between host and device.">cudaMemcpy2DArrayToArray</a>, <a class="el" href="group__CUDART__MEMORY_g58acd070e6f9bb82d7aeee3d0b958460.html#g58acd070e6f9bb82d7aeee3d0b958460" title="Copies data to the given symbol on the device.">cudaMemcpyToSymbol</a>, <a class="el" href="group__CUDART__MEMORY_g0b2cb4468ec7529fe24722f30e831a24.html#g0b2cb4468ec7529fe24722f30e831a24" title="Copies data from the given symbol on the device.">cudaMemcpyFromSymbol</a>, <a class="el" href="group__CUDART__MEMORY_ge4366f68c6fa8c85141448f187d2aa13.html#ge4366f68c6fa8c85141448f187d2aa13" title="Copies data between host and device.">cudaMemcpyAsync</a>, <a class="el" href="group__CUDART__MEMORY_g30c6e66c873a7e53a649f96b54b09465.html#g30c6e66c873a7e53a649f96b54b09465" title="Copies data between host and device.">cudaMemcpy2DAsync</a>, <a class="el" href="group__CUDART__MEMORY_g8e6d82b24a4482ed49ba242fd231a9a5.html#g8e6d82b24a4482ed49ba242fd231a9a5" title="Copies data between host and device.">cudaMemcpyToArrayAsync</a>, <a class="el" href="group__CUDART__MEMORY_ga0c91838976fe1d33014bd21bb9307bb.html#ga0c91838976fe1d33014bd21bb9307bb" title="Copies data between host and device.">cudaMemcpy2DToArrayAsync</a>, <a class="el" href="group__CUDART__MEMORY_g6759d51be63c55ecf65f95fe41812f99.html#g6759d51be63c55ecf65f95fe41812f99" title="Copies data between host and device.">cudaMemcpyFromArrayAsync</a>, <a class="el" href="group__CUDART__MEMORY_gad2e62119c537b9780b83a36d79340c6.html#gad2e62119c537b9780b83a36d79340c6" title="Copies data between host and device.">cudaMemcpy2DFromArrayAsync</a>, <a class="el" href="group__CUDART__MEMORY_g981a3eb36f49cd65e69eb575739ba5d7.html#g981a3eb36f49cd65e69eb575739ba5d7" title="Copies data to the given symbol on the device.">cudaMemcpyToSymbolAsync</a>, <a class="el" href="group__CUDART__MEMORY_gd714c659cb7b652fac87cb3ccdabd709.html#gd714c659cb7b652fac87cb3ccdabd709" title="Copies data from the given symbol on the device.">cudaMemcpyFromSymbolAsync</a> </dd></dl>
 143
 144 </div>
 145 </div><p>
 146     </td>
 147   </tr>
 148 </table>
 149 </div>
 150 <hr size="1"><address style="text-align: right;"><small>
 151 Generated by Doxygen on Mon Mar 30 23:16:11 2009 for NVIDIA CUDA Library &nbsp;<a
 152 href="http://www.nvidia.com/cuda"><img src="nvidia_logo.jpg" alt="NVIDIA" align="middle" border="0" height="80"></a></small></address>
 153 </body>
 154 </html>