102f4aeb0Sopenharmony_ci<?xml version="1.0" encoding="UTF-8" standalone="no"?>
202f4aeb0Sopenharmony_ci<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml">
302f4aeb0Sopenharmony_ci  <head>
402f4aeb0Sopenharmony_ci    <title xmlns:xlink="http://www.w3.org/1999/xlink">eglQueryString - EGL Reference Pages</title>
502f4aeb0Sopenharmony_ci    <link rel="stylesheet" type="text/css" href="khronos-man.css"/>
602f4aeb0Sopenharmony_ci    <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"/>
702f4aeb0Sopenharmony_ci  </head>
802f4aeb0Sopenharmony_ci  <body>
902f4aeb0Sopenharmony_ci    <header/>
1002f4aeb0Sopenharmony_ci    <div class="refentry" id="eglQueryString">
1102f4aeb0Sopenharmony_ci      <div class="titlepage"/>
1202f4aeb0Sopenharmony_ci      <div class="refnamediv">
1302f4aeb0Sopenharmony_ci        <h2>Name</h2>
1402f4aeb0Sopenharmony_ci        <p>eglQueryString — 
1502f4aeb0Sopenharmony_ci            return a string describing properties of the EGL client or of an
1602f4aeb0Sopenharmony_ci            <abbr class="acronym">EGL</abbr> display connection
1702f4aeb0Sopenharmony_ci        </p>
1802f4aeb0Sopenharmony_ci      </div>
1902f4aeb0Sopenharmony_ci      <div class="refsynopsisdiv">
2002f4aeb0Sopenharmony_ci        <h2>C Specification</h2>
2102f4aeb0Sopenharmony_ci        <div class="funcsynopsis">
2202f4aeb0Sopenharmony_ci          <table style="border: 0; cellspacing: 0; cellpadding: 0;" class="funcprototype-table">
2302f4aeb0Sopenharmony_ci            <tr>
2402f4aeb0Sopenharmony_ci              <td>
2502f4aeb0Sopenharmony_ci                <code class="funcdef">char const * <strong class="fsfunc">eglQueryString</strong>(</code>
2602f4aeb0Sopenharmony_ci              </td>
2702f4aeb0Sopenharmony_ci              <td>EGLDisplay <var class="pdparam">display</var>, </td>
2802f4aeb0Sopenharmony_ci            </tr>
2902f4aeb0Sopenharmony_ci            <tr>
3002f4aeb0Sopenharmony_ci              <td> </td>
3102f4aeb0Sopenharmony_ci              <td>EGLint <var class="pdparam">name</var><code>)</code>;</td>
3202f4aeb0Sopenharmony_ci            </tr>
3302f4aeb0Sopenharmony_ci          </table>
3402f4aeb0Sopenharmony_ci          <div class="funcprototype-spacer"> </div>
3502f4aeb0Sopenharmony_ci        </div>
3602f4aeb0Sopenharmony_ci      </div>
3702f4aeb0Sopenharmony_ci      <div class="refsect1" id="parameters">
3802f4aeb0Sopenharmony_ci        <h2>Parameters</h2>
3902f4aeb0Sopenharmony_ci        <div class="variablelist">
4002f4aeb0Sopenharmony_ci          <dl class="variablelist">
4102f4aeb0Sopenharmony_ci            <dt>
4202f4aeb0Sopenharmony_ci              <span class="term">
4302f4aeb0Sopenharmony_ci                <em class="parameter">
4402f4aeb0Sopenharmony_ci                  <code>display</code>
4502f4aeb0Sopenharmony_ci                </em>
4602f4aeb0Sopenharmony_ci              </span>
4702f4aeb0Sopenharmony_ci            </dt>
4802f4aeb0Sopenharmony_ci            <dd>
4902f4aeb0Sopenharmony_ci              <p>
5002f4aeb0Sopenharmony_ci                        Specifies the EGL display connection.
5102f4aeb0Sopenharmony_ci                    </p>
5202f4aeb0Sopenharmony_ci            </dd>
5302f4aeb0Sopenharmony_ci            <dt>
5402f4aeb0Sopenharmony_ci              <span class="term">
5502f4aeb0Sopenharmony_ci                <em class="parameter">
5602f4aeb0Sopenharmony_ci                  <code>name</code>
5702f4aeb0Sopenharmony_ci                </em>
5802f4aeb0Sopenharmony_ci              </span>
5902f4aeb0Sopenharmony_ci            </dt>
6002f4aeb0Sopenharmony_ci            <dd>
6102f4aeb0Sopenharmony_ci              <p>
6202f4aeb0Sopenharmony_ci                        Specifies a symbolic constant, one of
6302f4aeb0Sopenharmony_ci                        <code class="constant">EGL_CLIENT_APIS</code>,
6402f4aeb0Sopenharmony_ci                        <code class="constant">EGL_VENDOR</code>,
6502f4aeb0Sopenharmony_ci                        <code class="constant">EGL_VERSION</code>, or
6602f4aeb0Sopenharmony_ci                        <code class="constant">EGL_EXTENSIONS</code>.
6702f4aeb0Sopenharmony_ci                    </p>
6802f4aeb0Sopenharmony_ci            </dd>
6902f4aeb0Sopenharmony_ci          </dl>
7002f4aeb0Sopenharmony_ci        </div>
7102f4aeb0Sopenharmony_ci      </div>
7202f4aeb0Sopenharmony_ci      <div class="refsect1" id="description">
7302f4aeb0Sopenharmony_ci        <h2>Description</h2>
7402f4aeb0Sopenharmony_ci        <p>
7502f4aeb0Sopenharmony_ci            <code class="function">eglQueryString</code> returns a pointer to a
7602f4aeb0Sopenharmony_ci            static, zero-terminated string describing properties of the EGL
7702f4aeb0Sopenharmony_ci            client or of an EGL display connection.
7802f4aeb0Sopenharmony_ci            <em class="parameter"><code>name</code></em> may be one of the following:
7902f4aeb0Sopenharmony_ci        </p>
8002f4aeb0Sopenharmony_ci        <div class="variablelist">
8102f4aeb0Sopenharmony_ci          <dl class="variablelist">
8202f4aeb0Sopenharmony_ci            <dt>
8302f4aeb0Sopenharmony_ci              <span class="term">
8402f4aeb0Sopenharmony_ci                <code class="constant">EGL_CLIENT_APIS</code>
8502f4aeb0Sopenharmony_ci              </span>
8602f4aeb0Sopenharmony_ci            </dt>
8702f4aeb0Sopenharmony_ci            <dd>
8802f4aeb0Sopenharmony_ci              <p>
8902f4aeb0Sopenharmony_ci                    Returns a string describing which client rendering
9002f4aeb0Sopenharmony_ci                    APIs are supported. The string contains a
9102f4aeb0Sopenharmony_ci                    space-separated list of API names. The list must
9202f4aeb0Sopenharmony_ci                    include at least one of <code class="code">OpenGL</code>,
9302f4aeb0Sopenharmony_ci                    <code class="code">OpenGL_ES</code>, or <code class="code">OpenVG</code>.
9402f4aeb0Sopenharmony_ci                    These strings correspond respectively to values
9502f4aeb0Sopenharmony_ci                    <code class="constant">EGL_OPENGL_API</code>,
9602f4aeb0Sopenharmony_ci                    <code class="constant">EGL_OPENGL_ES_API</code>, and
9702f4aeb0Sopenharmony_ci                    <code class="constant">EGL_OPENVG_API</code> of the
9802f4aeb0Sopenharmony_ci                    <a class="citerefentry" href="eglBindAPI.xhtml"><span class="citerefentry"><span class="refentrytitle">eglBindAPI</span></span></a>,
9902f4aeb0Sopenharmony_ci                    <em class="parameter"><code>api</code></em> argument.
10002f4aeb0Sopenharmony_ci                </p>
10102f4aeb0Sopenharmony_ci            </dd>
10202f4aeb0Sopenharmony_ci            <dt>
10302f4aeb0Sopenharmony_ci              <span class="term">
10402f4aeb0Sopenharmony_ci                <code class="constant">EGL_VENDOR</code>
10502f4aeb0Sopenharmony_ci              </span>
10602f4aeb0Sopenharmony_ci            </dt>
10702f4aeb0Sopenharmony_ci            <dd>
10802f4aeb0Sopenharmony_ci              <p>
10902f4aeb0Sopenharmony_ci                    Returns the name of the vendor responsible for this EGL
11002f4aeb0Sopenharmony_ci                    implementation. The format and contents of the string
11102f4aeb0Sopenharmony_ci                    are implementation-dependent.
11202f4aeb0Sopenharmony_ci                </p>
11302f4aeb0Sopenharmony_ci            </dd>
11402f4aeb0Sopenharmony_ci            <dt>
11502f4aeb0Sopenharmony_ci              <span class="term">
11602f4aeb0Sopenharmony_ci                <code class="constant">EGL_VERSION</code>
11702f4aeb0Sopenharmony_ci              </span>
11802f4aeb0Sopenharmony_ci            </dt>
11902f4aeb0Sopenharmony_ci            <dd>
12002f4aeb0Sopenharmony_ci              <p>
12102f4aeb0Sopenharmony_ci                        Returns a version or release number. The
12202f4aeb0Sopenharmony_ci                        <code class="constant">EGL_VERSION</code> string is laid out
12302f4aeb0Sopenharmony_ci                        as follows:
12402f4aeb0Sopenharmony_ci                    </p>
12502f4aeb0Sopenharmony_ci              <p>
12602f4aeb0Sopenharmony_ci                        <em class="replaceable"><code>major_version</code></em>.<em class="replaceable"><code>minor_version</code></em>
12702f4aeb0Sopenharmony_ci                        space
12802f4aeb0Sopenharmony_ci                        <em class="replaceable"><code>vendor_specific_info</code></em>
12902f4aeb0Sopenharmony_ci                    </p>
13002f4aeb0Sopenharmony_ci              <p>
13102f4aeb0Sopenharmony_ci                        Both the major and minor portions of the version
13202f4aeb0Sopenharmony_ci                        number are numeric. Their values must match the
13302f4aeb0Sopenharmony_ci                        <em class="parameter"><code>major</code></em> and
13402f4aeb0Sopenharmony_ci                        <em class="parameter"><code>minor</code></em> values returned by
13502f4aeb0Sopenharmony_ci                        <a class="citerefentry" href="eglInitialize.xhtml"><span class="citerefentry"><span class="refentrytitle">eglInitialize</span></span></a>.
13602f4aeb0Sopenharmony_ci                    </p>
13702f4aeb0Sopenharmony_ci              <p>
13802f4aeb0Sopenharmony_ci                        The vendor-specific information is optional; if
13902f4aeb0Sopenharmony_ci                        present, its format and contents are
14002f4aeb0Sopenharmony_ci                        implementation-specific.
14102f4aeb0Sopenharmony_ci                    </p>
14202f4aeb0Sopenharmony_ci            </dd>
14302f4aeb0Sopenharmony_ci            <dt>
14402f4aeb0Sopenharmony_ci              <span class="term">
14502f4aeb0Sopenharmony_ci                <code class="constant">EGL_EXTENSIONS</code>
14602f4aeb0Sopenharmony_ci              </span>
14702f4aeb0Sopenharmony_ci            </dt>
14802f4aeb0Sopenharmony_ci            <dd>
14902f4aeb0Sopenharmony_ci              <p>
15002f4aeb0Sopenharmony_ci                        Returns a space separated list of supported
15102f4aeb0Sopenharmony_ci                        extensions to EGL. If there are no extensions, then
15202f4aeb0Sopenharmony_ci                        the empty string is returned.
15302f4aeb0Sopenharmony_ci                    </p>
15402f4aeb0Sopenharmony_ci              <p>
15502f4aeb0Sopenharmony_ci                        If <em class="parameter"><code>display</code></em> is
15602f4aeb0Sopenharmony_ci                        <code class="constant">EGL_NO_DISPLAY</code>, then the
15702f4aeb0Sopenharmony_ci                        <code class="constant">EGL_EXTENSIONS</code> string describes
15802f4aeb0Sopenharmony_ci                        the set of supported <em class="firstterm">client
15902f4aeb0Sopenharmony_ci                        extensions</em>. If
16002f4aeb0Sopenharmony_ci                        <em class="parameter"><code>display</code></em> is a valid,
16102f4aeb0Sopenharmony_ci                        initialized display, then the
16202f4aeb0Sopenharmony_ci                        <code class="constant">EGL_EXTENSIONS</code> string describes
16302f4aeb0Sopenharmony_ci                        the set of <em class="firstterm">display extensions</em>
16402f4aeb0Sopenharmony_ci                        supported by that display. The set of supported
16502f4aeb0Sopenharmony_ci                        client extensions is disjoint from the set of
16602f4aeb0Sopenharmony_ci                        extensions supported by any given display.
16702f4aeb0Sopenharmony_ci                    </p>
16802f4aeb0Sopenharmony_ci            </dd>
16902f4aeb0Sopenharmony_ci          </dl>
17002f4aeb0Sopenharmony_ci        </div>
17102f4aeb0Sopenharmony_ci      </div>
17202f4aeb0Sopenharmony_ci      <div class="refsect1" id="notes">
17302f4aeb0Sopenharmony_ci        <h2>Notes</h2>
17402f4aeb0Sopenharmony_ci        <p>
17502f4aeb0Sopenharmony_ci            <code class="constant">EGL_CLIENT_APIS</code> is supported only if
17602f4aeb0Sopenharmony_ci            the EGL version is 1.2 or greater.
17702f4aeb0Sopenharmony_ci        </p>
17802f4aeb0Sopenharmony_ci        <p>
17902f4aeb0Sopenharmony_ci            A <em class="parameter"><code>display</code></em> of
18002f4aeb0Sopenharmony_ci            <code class="constant">EGL_NO_DISPLAY</code> is supported only if the EGL
18102f4aeb0Sopenharmony_ci            version is 1.5 or greater.
18202f4aeb0Sopenharmony_ci        </p>
18302f4aeb0Sopenharmony_ci      </div>
18402f4aeb0Sopenharmony_ci      <div class="refsect1" id="errors">
18502f4aeb0Sopenharmony_ci        <h2>Errors</h2>
18602f4aeb0Sopenharmony_ci        <p>
18702f4aeb0Sopenharmony_ci            <code class="constant">NULL</code> is returned on failure.
18802f4aeb0Sopenharmony_ci        </p>
18902f4aeb0Sopenharmony_ci        <p>
19002f4aeb0Sopenharmony_ci            <code class="constant">EGL_BAD_DISPLAY</code> is generated if
19102f4aeb0Sopenharmony_ci            <em class="parameter"><code>display</code></em> is not an EGL display connection,
19202f4aeb0Sopenharmony_ci            unless <em class="parameter"><code>display</code></em> is
19302f4aeb0Sopenharmony_ci            <code class="constant">EGL_NO_DISPLAY</code> and
19402f4aeb0Sopenharmony_ci            <em class="parameter"><code>name</code></em> is
19502f4aeb0Sopenharmony_ci            <code class="constant">EGL_EXTENSIONS</code>.
19602f4aeb0Sopenharmony_ci        </p>
19702f4aeb0Sopenharmony_ci        <p>
19802f4aeb0Sopenharmony_ci            <code class="constant">EGL_NOT_INITIALIZED</code> is generated if
19902f4aeb0Sopenharmony_ci            <em class="parameter"><code>display</code></em> is a valid but uninitialized
20002f4aeb0Sopenharmony_ci            EGLDisplay.
20102f4aeb0Sopenharmony_ci        </p>
20202f4aeb0Sopenharmony_ci        <p>
20302f4aeb0Sopenharmony_ci            <code class="constant">EGL_BAD_PARAMETER</code> is generated if
20402f4aeb0Sopenharmony_ci            <em class="parameter"><code>name</code></em> is not an accepted value.
20502f4aeb0Sopenharmony_ci        </p>
20602f4aeb0Sopenharmony_ci      </div>
20702f4aeb0Sopenharmony_ci      <div class="refsect1" id="seealso">
20802f4aeb0Sopenharmony_ci        <h2>See Also</h2>
20902f4aeb0Sopenharmony_ci        <p>
21002f4aeb0Sopenharmony_ci            <a class="citerefentry" href="eglBindAPI.xhtml"><span class="citerefentry"><span class="refentrytitle">eglBindAPI</span></span></a>,
21102f4aeb0Sopenharmony_ci            <a class="citerefentry" href="eglGetDisplay.xhtml"><span class="citerefentry"><span class="refentrytitle">eglGetDisplay</span></span></a>,
21202f4aeb0Sopenharmony_ci            <a class="citerefentry" href="eglInitialize.xhtml"><span class="citerefentry"><span class="refentrytitle">eglInitialize</span></span></a>
21302f4aeb0Sopenharmony_ci        </p>
21402f4aeb0Sopenharmony_ci      </div>
21502f4aeb0Sopenharmony_ci      <p>
21602f4aeb0Sopenharmony_ci    </p>
21702f4aeb0Sopenharmony_ci      <div class="refsect3" id="copyright">
21802f4aeb0Sopenharmony_ci        <img src="KhronosLogo.jpg"/>
21902f4aeb0Sopenharmony_ci        <p>
22002f4aeb0Sopenharmony_ci            Copyright © 2003-2014 The Khronos Group Inc.
22102f4aeb0Sopenharmony_ci            Permission is hereby granted, free of charge, to any person obtaining a
22202f4aeb0Sopenharmony_ci            copy of this software and/or associated documentation files (the
22302f4aeb0Sopenharmony_ci            "Materials"), to deal in the Materials without restriction, including
22402f4aeb0Sopenharmony_ci            without limitation the rights to use, copy, modify, merge, publish,
22502f4aeb0Sopenharmony_ci            distribute, sublicense, and/or sell copies of the Materials, and to
22602f4aeb0Sopenharmony_ci            permit persons to whom the Materials are furnished to do so, subject to
22702f4aeb0Sopenharmony_ci            the condition that this copyright notice and permission notice shall be included
22802f4aeb0Sopenharmony_ci            in all copies or substantial portions of the Materials.
22902f4aeb0Sopenharmony_ci        </p>
23002f4aeb0Sopenharmony_ci      </div>
23102f4aeb0Sopenharmony_ci      <p>
23202f4aeb0Sopenharmony_ci</p>
23302f4aeb0Sopenharmony_ci    </div>
23402f4aeb0Sopenharmony_ci    <footer/>
23502f4aeb0Sopenharmony_ci  </body>
23602f4aeb0Sopenharmony_ci</html>
237