<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>VDPAU: Versioning</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="doxygen.css" rel="stylesheet" type="text/css"/> </head> <body> <!-- Generated by Doxygen 1.6.2 --> <div class="navigation" id="top"> <div class="tabs"> <ul> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li><a href="files.html"><span>Files</span></a></li> <li><a href="dirs.html"><span>Directories</span></a></li> </ul> </div> </div> <div class="contents"> <h1>Versioning<br/> <small> [<a class="el" href="group__api__core.html">Core API</a>]</small> </h1> <p><div class="dynheader"> Collaboration diagram for Versioning:</div> <div class="dynsection"> <center><table><tr><td><img src="group__versioning.png" border="0" alt="" usemap="#group____versioning_map"/> <map name="group____versioning_map" id="group____versioning"> <area shape="rect" id="node1" href="group__api__core.html" title="Core API" alt="" coords="7,5,81,35"/></map></td></tr></table></center> </div> </p> <table border="0" cellpadding="0" cellspacing="0"> <tr><td colspan="2"><h2>Defines</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__versioning.html#ga9d78b81d854b0c72ce5d22454c014675">VDPAU_INTERFACE_VERSION</a> 1</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The VDPAU interface version described by this header file. <a href="#ga9d78b81d854b0c72ce5d22454c014675"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__versioning.html#ga9cba83b45af1ee8fb84c4f8f4aae2c20">VDPAU_VERSION</a> 1</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The VDPAU version described by this header file. <a href="#ga9cba83b45af1ee8fb84c4f8f4aae2c20"></a><br/></td></tr> <tr><td colspan="2"><h2>Typedefs</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">typedef <a class="el" href="group__error__handling.html#ga7fa6c302213052e531b20bab723e5778">VdpStatus</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__versioning.html#ga05320472b758f55cf33d3a5aa4d83e93">VdpGetApiVersion</a> (uint32_t *api_version)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the VDPAU version implemented by the backend. <a href="#ga05320472b758f55cf33d3a5aa4d83e93"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">typedef <a class="el" href="group__error__handling.html#ga7fa6c302213052e531b20bab723e5778">VdpStatus</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__versioning.html#ga44522882b93596a306fb304d87b13825">VdpGetInformationString</a> (char const **information_string)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve an implementation-specific string description of the implementation. This typically includes detailed version information. <a href="#ga44522882b93596a306fb304d87b13825"></a><br/></td></tr> </table> <hr/><h2>Define Documentation</h2> <a class="anchor" id="ga9d78b81d854b0c72ce5d22454c014675"></a><!-- doxytag: member="vdpau.h::VDPAU_INTERFACE_VERSION" ref="ga9d78b81d854b0c72ce5d22454c014675" args="" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define VDPAU_INTERFACE_VERSION 1</td> </tr> </table> </div> <div class="memdoc"> <p>The VDPAU interface version described by this header file. </p> <p>This version will only increase if a major incompatible change is made. For example, if the parameters passed to an existing function are modified, rather than simply adding new functions/enumerations), or if the mechanism used to load the backend driver is modified incompatibly. Such changes are unlikely.</p> <p>This value also represents the DSO version of VDPAU-related shared-libraries.</p> <p>VDPAU version numbers are simple integers that increase monotonically (typically by value 1). </p> </div> </div> <a class="anchor" id="ga9cba83b45af1ee8fb84c4f8f4aae2c20"></a><!-- doxytag: member="vdpau.h::VDPAU_VERSION" ref="ga9cba83b45af1ee8fb84c4f8f4aae2c20" args="" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">#define VDPAU_VERSION 1</td> </tr> </table> </div> <div class="memdoc"> <p>The VDPAU version described by this header file. </p> <p>This version will increase whenever any non-documentation change is made to <a class="el" href="vdpau_8h.html" title="The Core API.">vdpau.h</a>, or related header files such as <a class="el" href="vdpau__x11_8h.html" title="X11 Window System Integration Layer.">vdpau_x11.h</a>. Such changes typically involve the addition of new functions, constants, or features. Such changes are expected to be completely backwards-compatible.</p> <p>VDPAU version numbers are simple integers that increase monotonically (typically by value 1). </p> </div> </div> <hr/><h2>Typedef Documentation</h2> <a class="anchor" id="ga05320472b758f55cf33d3a5aa4d83e93"></a><!-- doxytag: member="vdpau.h::VdpGetApiVersion" ref="ga05320472b758f55cf33d3a5aa4d83e93" args="(uint32_t *api_version)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">typedef <a class="el" href="group__error__handling.html#ga7fa6c302213052e531b20bab723e5778">VdpStatus</a> <a class="el" href="group__versioning.html#ga05320472b758f55cf33d3a5aa4d83e93">VdpGetApiVersion</a>(uint32_t *api_version)</td> </tr> </table> </div> <div class="memdoc"> <p>Retrieve the VDPAU version implemented by the backend. </p> <dl><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>api_version</em> </td><td>The API version. </td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>VdpStatus The completion status of the operation. </dd></dl> </div> </div> <a class="anchor" id="ga44522882b93596a306fb304d87b13825"></a><!-- doxytag: member="vdpau.h::VdpGetInformationString" ref="ga44522882b93596a306fb304d87b13825" args="(char const **information_string)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">typedef <a class="el" href="group__error__handling.html#ga7fa6c302213052e531b20bab723e5778">VdpStatus</a> <a class="el" href="group__versioning.html#ga44522882b93596a306fb304d87b13825">VdpGetInformationString</a>(char const **information_string)</td> </tr> </table> </div> <div class="memdoc"> <p>Retrieve an implementation-specific string description of the implementation. This typically includes detailed version information. </p> <dl><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>information_string</em> </td><td>A pointer to the information string. Note that this is a statically allocated read-only string. As such, the application must not free the returned pointer. The pointer is valid as long as the implementation is present within the application's address space. </td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>VdpStatus The completion status of the operation.</dd></dl> <p>Note that the returned string is useful for information reporting. It is not intended that the application should parse this string in order to determine any information about the implementation. </p> </div> </div> </div> <hr size="1"/><address style="text-align: right;"><small>Generated by <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address> </body> </html>