1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>drm_vma_offset_lookup</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#idp1122718668" title="VMA Offset Manager"><link rel="prev" href="API-drm-vma-offset-manager-destroy.html" title="drm_vma_offset_manager_destroy"><link rel="next" href="API-drm-vma-offset-lookup-locked.html" title="drm_vma_offset_lookup_locked"></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_vma_offset_lookup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-drm-vma-offset-manager-destroy.html">Prev</a>&#160;</td><th width="60%" align="center">VMA Offset Manager</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-drm-vma-offset-lookup-locked.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-drm-vma-offset-lookup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>drm_vma_offset_lookup &#8212; 
2     Find node in offset space
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">struct drm_vma_offset_node * <b class="fsfunc">drm_vma_offset_lookup </b>(</code></td><td>struct drm_vma_offset_manager * <var class="pdparam">mgr</var>, </td></tr><tr><td>&#160;</td><td>unsigned long <var class="pdparam">start</var>, </td></tr><tr><td>&#160;</td><td>unsigned long <var class="pdparam">pages</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1122746476"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>mgr</code></em></span></dt><dd><p>
4     Manager object
5    </p></dd><dt><span class="term"><em class="parameter"><code>start</code></em></span></dt><dd><p>
6     Start address for object (page-based)
7    </p></dd><dt><span class="term"><em class="parameter"><code>pages</code></em></span></dt><dd><p>
8     Size of object (page-based)
9    </p></dd></dl></div></div><div class="refsect1"><a name="idp1122750012"></a><h2>Description</h2><p>
10   Find a node given a start address and object size. This returns the _best_
11   match for the given node. That is, <em class="parameter"><code>start</code></em> may point somewhere into a valid
12   region and the given node will be returned, as long as the node spans the
13   whole requested area (given the size in number of pages as <em class="parameter"><code>pages</code></em>).
14</p></div><div class="refsect1"><a name="idp1122751524"></a><h2>RETURNS</h2><p>
15   Returns NULL if no suitable node can be found. Otherwise, the best match
16   is returned. It's the caller's responsibility to make sure the node doesn't
17   get destroyed before the caller can access it.
18</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-vma-offset-manager-destroy.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="drm-memory-management.html#idp1122718668">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-drm-vma-offset-lookup-locked.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">drm_vma_offset_manager_destroy</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_vma_offset_lookup_locked</span></td></tr></table></div></body></html>
19