sdk/2.1/docs/man/cl_context_properties_Inc.xml

<!-- table 4.5 applies to:
cl_context_properties properties in clCreateContext
cl_context_properties properties in clGetGLContextInfoKHR
cl_context_properties properties in clCreateContextFromType
-->

    <para>List of supported <varname>properties</varname> (Table 4.5)</para>

    <informaltable frame="all"><tgroup cols="3" align="left" colsep="1" rowsep="1">
        <colspec colname="col1" colnum="1" />
        <colspec colname="col2" colnum="2" />
        <colspec colname="col3" colnum="3" />
        <thead>
            <row>
            <entry>cl_context_properties enum</entry>
            <entry>Property value</entry>
            <entry>Description</entry>
            </row>
        </thead>

        <tbody>
            <row>
                <entry><constant>CL_CONTEXT_PLATFORM</constant></entry>
                <entry>cl_platform_id</entry>
                <entry>Specifies the platform to use.</entry>
            </row>

            <row>
                <entry><constant>CL_CONTEXT_INTEROP_USER_SYNC</constant></entry>
                <entry>cl_bool</entry>
                <entry>Specifies whether the user is responsible for synchronization
                between OpenCL and other APIs. Please refer to the specific sections
                in the OpenCL 2.0 extension specification that describe sharing with
                other APIs for restrictions on using this flag. If
                <constant>CL_CONTEXT_INTEROP_USER_SYNC</constant> is not specified, a
                default of <constant>CL_FALSE</constant> is assumed.
                OpenCL / OpenGL sharing does not support the 
                <constant>CL_CONTEXT_INTEROP_USER_SYNC</constant>
                property defined in table 4.5. Specifying this 
                property when creating a context with OpenCL / 
                OpenGL sharing will return an appropriate error.</entry>
            </row>

            <row>
                <entry><constant>CL_CONTEXT_D3D10_DEVICE_KHR</constant></entry>
                <entry><type>ID3D10Device</type> *</entry>
                <entry>
                  Specifies the <type>ID3D10Device</type> * to use for Direct3D 10
                  interoperability.  The default value is NULL (applies if the extension
                  <citerefentry><refentrytitle>cl_khr_d3d10_sharing</refentrytitle></citerefentry>
                  is supported)
                </entry>
            </row>

            <row>
                <entry><constant>CL_CONTEXT_ADAPTER_D3D9_KHR</constant></entry>
                <entry><type>IDirect3DDevice9</type> *</entry>
                <entry>
                  Specifies an <type>IDirect3DDevice9</type>
                  to use for D3D9 interop (applies if the
                  <citerefentry><refentrytitle>cl_khr_dx9_media_sharing</refentrytitle></citerefentry>
                  extension is supported)
                </entry>
            </row>

            <row>
                <entry><constant>CL_CONTEXT_ADAPTER_D3D9EX_KHR</constant></entry>
                <entry><type>IDirect3DDeviceEx</type> *</entry>
                <entry>
                  Specifies an <type>IDirect3DDevice9Ex</type>
                  to use for D3D9 interop (applies if the
                  <citerefentry><refentrytitle>cl_khr_dx9_media_sharing</refentrytitle></citerefentry>
                  extension is supported)
                </entry>
            </row>

            <row>
                <entry><constant>CL_CONTEXT_ADAPTER_DXVA_KHR</constant></entry>
                <entry><type>IDXVAHD_Device</type> *</entry>
                <entry>
                  Specifies an <type>IDXVAHD_Device</type>
                  to use for DXVA interop (applies if the
                  <citerefentry><refentrytitle>cl_khr_dx9_media_sharing</refentrytitle></citerefentry>
                  extension is supported)
                </entry>
            </row>

            <row>
                <entry><constant>CL_GL_CONTEXT_KHR</constant></entry>
                <entry>0, OpenGL context handle</entry>
                <entry>
                  OpenGL context to associated
                  the OpenCL context with (available if the
                  <citerefentry><refentrytitle>cl_khr_gl_sharing</refentrytitle></citerefentry>
                  extension is enabled)
                </entry>
            </row>

            <row>
                <entry><constant>CL_CGL_SHAREGROUP_KHR</constant></entry>
                <entry>0, CGL share group handle</entry>
                <entry>
                  CGL share group to associate
                  the OpenCL context with (available if the
                  <citerefentry><refentrytitle>cl_khr_gl_sharing</refentrytitle></citerefentry>
                  extension is enabled)
                </entry>
            </row>

            <row>
                <entry><constant>CL_EGL_DISPLAY_KHR</constant></entry>
                <entry> <constant>EGL_NO_DISPLAY</constant>, <type>EGLDisplay</type> handle </entry>
                <entry>
                  EGLDisplay an OpenGL context was created with respect to (available if the
                  <citerefentry><refentrytitle>cl_khr_gl_sharing</refentrytitle></citerefentry>
                  extension is enabled)
                </entry>
            </row>

            <row>
                <entry><constant>CL_GLX_DISPLAY_KHR</constant></entry>
                <entry>None, X handle</entry>
                <entry>
                  X Display an OpenGL context was
                  created with respect to (available if the
                  <citerefentry><refentrytitle>cl_khr_gl_sharing</refentrytitle></citerefentry>
                  extension is enabled)
                </entry>
            </row>

            <row>
                <entry><constant>CL_WGL_HDC_KHR</constant></entry>
                <entry>0, HDC handle</entry>
                <entry>
                  HDC an OpenGL context was created with respect to (available if the
                  <citerefentry><refentrytitle>cl_khr_gl_sharing</refentrytitle></citerefentry>
                  extension is enabled)
                </entry>
            </row>

            <row>
                <entry><constant>CL_CONTEXT_D3D11_DEVICE_KHR</constant></entry>
                <entry><type>ID3D11Device</type> *</entry>
                <entry>
                  Specifies the <type>ID3D11Device</type>  * to use for Direct3D
                  11 interoperability. The default value is NULL. (Applies if the
                  <citerefentry><refentrytitle>cl_khr_d3d11_sharing</refentrytitle></citerefentry>
                  extension is supported.)
                </entry>
            </row>

            <row>
                <entry><constant>CL_CONTEXT_MEMORY_INITIALIZE_KHR</constant></entry>
                <entry><type>cl_context_memory-
_initialize_khr</type></entry>
                <entry>
                    <para>
                        Describes which memory types for the 
                        context must be initialized. This is a 
                        bit-field, where the following values are 
                        currently supported:
                    </para>

                    <para>
                        <constant>CL_CONTEXT_MEMORY_INITIALIZE_LOCAL_KHR</constant> - Initialize local memory 
                        to zeros.
                    </para>

                    <para>
                        <constant>CL_CONTEXT_MEMORY_INITIALIZE_PRIVATE_KHR</constant> - Initialize private 
                        memory to zeros.
                    </para>

                    <para>
                      (applies if the
                      <citerefentry><refentrytitle>cl_khr_initialize_memory</refentrytitle></citerefentry>
                      extension is supported)
                    </para>

                </entry>
            </row>

            <row>
                <entry><constant>CL_CONTEXT_TERMINATE_KHR</constant></entry>
                <entry><type>cl_bool</type></entry>
                <entry>
                    Specifies whether the context can be 
                    terminated. The default value is 
                    <constant>CL_FALSE</constant>.
                    (applies if the
                  <citerefentry><refentrytitle>cl_khr_terminate_context</refentrytitle></citerefentry>
                  extension is supported)
                </entry>
            </row>

        </tbody>

        </tgroup>
    </informaltable>

<!-- 21-Oct-2015, API rev. 19; Ext rev. 10 -->