1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>drm_gem_prime_fd_to_handle</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Linux DRM Developer's Guide"><link rel="up" href="drm-memory-management.html#idp1122911796" title="PRIME Function References"><link rel="prev" href="API-drm-gem-prime-import.html" title="drm_gem_prime_import"><link rel="next" href="API-drm-prime-pages-to-sg.html" title="drm_prime_pages_to_sg"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">drm_gem_prime_fd_to_handle</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-drm-gem-prime-import.html">Prev</a>&#160;</td><th width="60%" align="center">PRIME Function References</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-drm-prime-pages-to-sg.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-drm-gem-prime-fd-to-handle"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>drm_gem_prime_fd_to_handle &#8212; 
2     PRIME import function for GEM drivers
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">drm_gem_prime_fd_to_handle </b>(</code></td><td>struct drm_device * <var class="pdparam">dev</var>, </td></tr><tr><td>&#160;</td><td>struct drm_file * <var class="pdparam">file_priv</var>, </td></tr><tr><td>&#160;</td><td>int <var class="pdparam">prime_fd</var>, </td></tr><tr><td>&#160;</td><td>uint32_t * <var class="pdparam">handle</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1122954620"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
4     dev to export the buffer from
5    </p></dd><dt><span class="term"><em class="parameter"><code>file_priv</code></em></span></dt><dd><p>
6     drm file-private structure
7    </p></dd><dt><span class="term"><em class="parameter"><code>prime_fd</code></em></span></dt><dd><p>
8     fd id of the dma-buf which should be imported
9    </p></dd><dt><span class="term"><em class="parameter"><code>handle</code></em></span></dt><dd><p>
10     pointer to storage for the handle of the imported buffer object
11    </p></dd></dl></div></div><div class="refsect1"><a name="idp1122959244"></a><h2>Description</h2><p>
12   This is the PRIME import function which must be used mandatorily by GEM
13   drivers to ensure correct lifetime management of the underlying GEM object.
14   The actual importing of GEM object from the dma-buf is done through the
15   gem_import_export driver callback.
16</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-drm-gem-prime-import.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="drm-memory-management.html#idp1122911796">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-drm-prime-pages-to-sg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">drm_gem_prime_import</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">drm_prime_pages_to_sg</span></td></tr></table></div></body></html>
17