1<?xml version="1.0" encoding="UTF-8"?> 2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN" 3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd"> 4<refentry xml:base="" id="eglGetProcAddress"> 5 <refentryinfo> 6 <copyright> 7 <year>2003-2014</year> 8 <holder>The Khronos Group Inc.</holder> 9 </copyright> 10 </refentryinfo> 11 <refmeta> 12 <refentrytitle>eglGetProcAddress</refentrytitle> 13 <manvolnum>3G</manvolnum> 14 </refmeta> 15 <refnamediv> 16 <refname>eglGetProcAddress</refname> 17 <refpurpose> 18 return a <acronym>GL</acronym> or an <acronym>EGL</acronym> 19 extension function 20 </refpurpose> 21 </refnamediv> 22 <refsynopsisdiv> 23 <title>C Specification</title> 24 <funcsynopsis> 25 <funcprototype> 26 <funcdef>void (* <function>eglGetProcAddress</function>)()</funcdef> 27 <paramdef>char const * <parameter>procname</parameter></paramdef> 28 </funcprototype> 29 </funcsynopsis> 30 </refsynopsisdiv> 31 <refsect1 id="parameters"><title>Parameters</title> 32 <variablelist> 33 <varlistentry> 34 <term><parameter>procname</parameter></term> 35 <listitem> 36 <para> 37 Specifies the name of the function to return. 38 </para> 39 </listitem> 40 </varlistentry> 41 </variablelist> 42 </refsect1> 43 <refsect1 id="description"><title>Description</title> 44 <para> 45 <function>eglGetProcAddress</function> returns the address of 46 the extension function named by <parameter>procname</parameter>. 47 <parameter>procname</parameter> 48 must be a null-terminated string. The pointer returned 49 should be cast to a function pointer type matching the extension 50 function's definition in that extension specification. A return value 51 of <constant>NULL</constant> indicates that the specific 52 function does not exist for the <acronym>EGL</acronym> implementation. 53 </para> 54 <para> 55 A non-<constant>NULL</constant> return value does not guarantee 56 that an extension function is actually supported at runtime. The client 57 must also query 58 <citerefentry><refentrytitle>glGetString</refentrytitle></citerefentry>(<constant>GL_EXTENSIONS</constant>) or 59 <citerefentry><refentrytitle>eglQueryString</refentrytitle></citerefentry>(<parameter>display</parameter>, 60 <constant>EGL_EXTENSIONS</constant>) to determine if an 61 extension is supported by a particular context or display. 62 </para> 63 <para> 64 Function pointers returned by 65 <function>eglGetProcAddress</function> are independent of the 66 display and the currently bound context and may be used by any context 67 which supports the extension. 68 </para> 69 <para> 70 <function>eglGetProcAddress</function> may be queried for all 71 <acronym>GL</acronym> and <acronym>EGL</acronym> extension functions. 72 </para> 73 </refsect1> 74 <refsect1 id="seealso"><title>See Also</title> 75 <para> 76 <citerefentry><refentrytitle>glGetString</refentrytitle></citerefentry>, 77 <citerefentry><refentrytitle>eglQueryString</refentrytitle></citerefentry> </para> 78 </refsect1> 79 <refsect3 id="Copyright"><title></title> 80 <!-- Content included from copyright.inc.xsl --> 81 <imageobject> 82 <imagedata fileref="KhronosLogo.jpg" format="jpg" /> 83 </imageobject> 84 <para /> 85 </refsect3> 86</refentry> 87
