| <?xml version="1.0" encoding="UTF-8"?> | 
 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd"> | 
 | <!-- saved from url=(0013)about:internet --> | 
 | <?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" xmlns:xlink="http://www.w3.org/1999/xlink" pref:renderer="mathplayer-dl"> | 
 |   <head> | 
 |     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> | 
 |     <style xmlns="" type="text/css"> | 
 |     /* This style sets a margin around the entire page */ | 
 |         html, body { | 
 |             margin: 10px; | 
 |         } | 
 |  | 
 |         p { | 
 |             font: normal 16px verdana, sans-serif; | 
 |             margin: 0; | 
 |             padding-bottom:12px; | 
 |         } | 
 |  | 
 |         h1 { | 
 |             font: bold 25px verdana, sans-serif; | 
 |             margin-top: 0; | 
 |             margin-bottom: 3px; | 
 |             padding-top: 0; | 
 |             padding-bottom: 0; | 
 |         } | 
 |  | 
 |         h2 { | 
 |             font: bold 19px verdana, sans-serif; | 
 |             margin-top: 28px; | 
 |             margin-bottom: 3px; | 
 |             padding-top: 0; | 
 |             padding-bottom: 0; | 
 |         } | 
 |  | 
 |         h3 { | 
 |             font: bold 19px verdana, sans-serif !important; | 
 |             margin-top: 28px; | 
 |             margin-bottom: 3px; | 
 |             padding-top: 0; | 
 |             padding-bottom: 0; | 
 |         } | 
 |  | 
 |         li { | 
 |             font: normal 16px verdana, sans-serif; | 
 |             margin-top: 0; | 
 |             margin-bottom: 18px; | 
 |             padding-top: 0; | 
 |             padding-bottom: 0; | 
 |         } | 
 |  | 
 |         .pdparam { | 
 |             font: italic 16px verdana, sans-serif; | 
 |         } | 
 |  | 
 |                 .term { | 
 |                         font: italic 16px verdana, sans-serif; | 
 |                         font-weight: normal; | 
 |                 } | 
 |  | 
 |                 .type { | 
 |                         font: normal 16px verdana, sans-serif !important; | 
 |                 } | 
 |  | 
 |                 .parameter { | 
 |                         font-style: italic; | 
 |                         } | 
 |  | 
 |         a:link, a:visited { | 
 |             color: blue; | 
 |             text-decoration: none; | 
 |             font: normal 16px; | 
 |         } | 
 |  | 
 |         a:hover { | 
 |             background-color: #FFFF99; | 
 |             font: normal 16px; | 
 |         } | 
 |  | 
 |         div.funcsynopsis { | 
 |             text-align: left; | 
 |             background-color: #e6e6e6; | 
 |             font: normal 16px verdana, sans-serif; | 
 |                         padding-top: 10px; | 
 |                         padding-bottom: 10px; | 
 |         } | 
 |  | 
 |         div.funcsynopsis table { | 
 |             border-collapse: separate; | 
 |             font: normal 16px verdana, sans-serif; | 
 |         } | 
 |  | 
 |         div.funcsynopsis td { | 
 |             background-color: #e6e6e6; | 
 |             border: 0 solid #000; | 
 |             padding: 1px; | 
 |             font: normal 16px verdana, sans-serif; | 
 |         } | 
 |  | 
 |         div.refsect1 { | 
 |             font-family: verdana, sans-serif; | 
 |             font-size: 16px; | 
 |         } | 
 |  | 
 |         code.constant { | 
 |             font: normal 16px courier new, monospace !important; | 
 |         } | 
 |  | 
 |                 span.errorname { | 
 |             font: normal 16px verdana, sans-serif !important; | 
 |         } | 
 |  | 
 |         code.function { | 
 |             font: bold 16px verdana, sans-serif !important; | 
 |         } | 
 |  | 
 |         b.fsfunc { | 
 |             font: bold 16px verdana, sans-serif !important; | 
 |         } | 
 |  | 
 |         code.varname { | 
 |             font: italic 16px verdana, sans-serif; | 
 |         } | 
 |  | 
 |         code.replaceable { | 
 |             font: italic 16px courier new, monospace; | 
 |         } | 
 |  | 
 |         code.funcdef { | 
 |             font: normal 16px verdana, sans-serif !important; | 
 |         } | 
 |  | 
 |         .citerefentry { | 
 |             font: normal 16px verdana, sans-serif !important; | 
 |         } | 
 |  | 
 |         .parameter { | 
 |             font-style: italic; | 
 |         } | 
 |  | 
 |         code.fsfunc { | 
 |             font: normal 16px verdana, sans-serif !important; | 
 |         } | 
 |  | 
 |         /* PARAMETER: This style controls spacing between the terms in Parameter section */ | 
 |         dt { | 
 |             margin-top: 15px; | 
 |         } | 
 |  | 
 |         /* TABLES: These styles apply to all tables OTHER than the Synopsis and Example tables */ | 
 |         div.refsect1 table { | 
 |             width: 100%; | 
 |                         margin-top: 10px; | 
 |             background-color: #FFF; | 
 |                         border-collapse: collapse; | 
 |                         border-color: #000; | 
 |             border-width: 1px; | 
 |                         font: normal 16px verdana, sans-serif; | 
 |         } | 
 |  | 
 |         div.refsect1 th { | 
 |                         border-collapse: collapse; | 
 |                         border-color: #000; | 
 |             border-width: 1px; | 
 |             font: bold 16px verdana, sans-serif; | 
 |         } | 
 |  | 
 |         div.refsect1 td { | 
 |             background-color: #FFF; | 
 |             padding: 5px; | 
 |             vertical-align: text-top; | 
 |                         border-collapse: collapse; | 
 |                         border-color: #000; | 
 |             border-width: 1px; | 
 |             font: normal 16px verdana, sans-serif; | 
 |         } | 
 |  | 
 |                   div.refsect1 p{ | 
 |             font: normal 16px verdana, sans-serif; | 
 |             margin-top: 8px; | 
 |             margin-bottom: 8px; | 
 |             padding-top: 0; | 
 |             padding-bottom: 0; | 
 |         } | 
 |  | 
 |  | 
 |         /* EXAMPLE: These styles apply only to the Example section */ | 
 |         div.refsect2 { | 
 |             font: normal 16px courier new, monospace !important; | 
 |         } | 
 |  | 
 |         div.refsect2 table { | 
 |             margin-top: 0; | 
 |             background-color: #e6e6e6; | 
 |             width: 100%; | 
 |             border: 0 solid #000; | 
 |             padding: 2px; | 
 |             font: normal 16px courier new, monospace !important; | 
 |         } | 
 |  | 
 |         div.refsect2 td { | 
 |             background-color: #e6e6e6; | 
 |             font: normal 16px courier new, monospace !important; | 
 |                         white-space:pre; | 
 |         } | 
 |  | 
 |         /* COPYRIGHT: This style formats the text of the copyright statement at the bottom of the page */ | 
 |         div.refsect3 { | 
 |             font: normal 11px verdana, sans-serif; | 
 |             margin-top: 50px; | 
 |             margin-bottom: 20px; | 
 |             padding-top: 0; | 
 |             padding-bottom: 0; | 
 |         } | 
 |  | 
 | </style> | 
 |     <title>clTerminateContextKHR</title> | 
 |     <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /> | 
 |     <meta name="keywords" content="clTerminateContextKHR" /> | 
 |   </head> | 
 |   <body> | 
 |     <div class="refentry"> | 
 |       <a id="id-1"></a> | 
 |       <div class="titlepage"></div> | 
 |       <div xmlns="" class="refnamediv"> | 
 |         <a xmlns="http://www.w3.org/1999/xhtml" id="clTerminateContextKHR"></a> | 
 |         <h1> | 
 |             clTerminateContextKHR | 
 |         </h1> | 
 |         <p> | 
 |             Terminates all pending work associated with the context and renders all data owned by the context invalid. | 
 |         </p> | 
 |       </div> | 
 |       <div class="refsynopsisdiv"> | 
 |         <h2></h2> | 
 |         <div class="funcsynopsis"> | 
 |           <table xmlns="" border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"> | 
 |             <tr valign="bottom"> | 
 |               <td> | 
 |                 <code xmlns="http://www.w3.org/1999/xhtml" class="funcdef"> | 
 |                     <a class="link" href="scalarDataTypes.html" target="pagedisplay">cl_int</a> <strong class="fsfunc">clTerminateContextKHR</strong> | 
 |                 (</code> | 
 |                 <td><a xmlns="http://www.w3.org/1999/xhtml" class="link" href="abstractDataTypes.html" target="pagedisplay">cl_context</a>  <var xmlns="http://www.w3.org/1999/xhtml" class="pdparam">context</var><code>)</code></td> | 
 |               </td> | 
 |             </tr> | 
 |           </table> | 
 |         </div> | 
 |       </div> | 
 |       <div class="refsect1"> | 
 |         <a id="parameters"></a> | 
 |         <h2>Parameters</h2> | 
 |         <div class="variablelist"> | 
 |           <dl class="variablelist"></dl> | 
 |         </div> | 
 |       </div> | 
 |       <div class="refsect1"> | 
 |         <a id="notes"></a> | 
 |         <h2>Notes</h2> | 
 |         <p> | 
 |             It is the responsibility of the application to release all objects associated with the  | 
 |             context being terminated. | 
 |         </p> | 
 |         <p> | 
 |             When a context is terminated: | 
 |         </p> | 
 |         <div class="itemizedlist"> | 
 |           <ul class="itemizedlist" style="list-style-type: opencircle; "> | 
 |             <li class="listitem" style="list-style-type: circle"> | 
 |               <p> | 
 |                 The execution status of enqueued commands will be  | 
 |                 <code class="constant">CL_TERMINATED_KHR</code>. Event  | 
 |                 objects can be queried using  | 
 |                 <a class="citerefentry" href="clGetEventInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetEventInfo</span></span></a>.  | 
 |                 Event callbacks can be registered and  | 
 |                 registered event callbacks will be called with  | 
 |                 <code class="varname">event_command_exec_status</code> set to  | 
 |                 <code class="constant">CL_TERMINATED_KHR</code>.  | 
 |                 <a class="citerefentry" href="clWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clWaitForEvents</span></span></a>  | 
 |                 will return as immediately for commands  | 
 |                 associated with event objects specified in  | 
 |                 <code class="varname">event_list</code>. The status of user events can be set.  | 
 |                 Event objects can be retained and released.  | 
 |                 <a class="citerefentry" href="clGetEventProfilingInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetEventProfilingInfo</span></span></a>   | 
 |                 returns  | 
 |                 <span class="errorname">CL_PROFILING_INFO_NOT_AVAILABLE</span>. | 
 |             </p> | 
 |             </li> | 
 |             <li class="listitem" style="list-style-type: circle"> | 
 |               <p> | 
 |                 The context is considered to be terminated.  | 
 |                 A callback function registered when the  | 
 |                 context was created will be called. Only  | 
 |                 queries, retain and release operations can be  | 
 |                 performed on the context. All other APIs that  | 
 |                 use a context as an argument will return  | 
 |                 <span class="errorname">CL_CONTEXT_TERMINATED_KHR</span>. | 
 |             </p> | 
 |             </li> | 
 |             <li class="listitem" style="list-style-type: circle"> | 
 |               <p> | 
 |                 The contents of the memory regions of the  | 
 |                 memory objects is undefined. Queries,  | 
 |                 registering a destructor callback, retain  | 
 |                 and release operations can be performed on the  | 
 |                 memory objects. | 
 |             </p> | 
 |             </li> | 
 |             <li class="listitem" style="list-style-type: circle"> | 
 |               <p> | 
 |                 Once a context has been terminated, all OpenCL API  | 
 |                 calls that create objects or enqueue  | 
 |                 commands will return  | 
 |                 <span class="errorname">CL_CONTEXT_TERMINATED_KHR</span>.  | 
 |                 APIs that release OpenCL  | 
 |                 objects will continue to operate as though  | 
 |                 <code class="function">clTerminateContextKHR</code> was not called. | 
 |             </p> | 
 |             </li> | 
 |             <li class="listitem" style="list-style-type: circle"> | 
 |               <p> | 
 |                 The behavior of callbacks will remain unchanged,  | 
 |                 and will report appropriate error, if  | 
 |                 executing after termination of context. This  | 
 |                 behavior is similar to enqueued commands,  | 
 |                 after the command queue has become invalid. | 
 |             </p> | 
 |             </li> | 
 |           </ul> | 
 |         </div> | 
 |         <p> | 
 |             An implementation that supports this extension  | 
 |             must be able to terminate commands currently  | 
 |             executing on devices or queued across all  | 
 |             command-queues associated with the context that is  | 
 |             being terminated. The implementation cannot  | 
 |             implement this extension by waiting for currently  | 
 |             executing (or queued) commands to finish execution  | 
 |             on devices associated with this context (i.e. | 
 |             doing a <a class="citerefentry" href="clFinish.html"><span class="citerefentry"><span class="refentrytitle">clFinish</span></span></a>). | 
 |         </p> | 
 |         <p> | 
 |             In Table 4.5, (see  | 
 |             <a class="citerefentry" href="clCreateContext.html"><span class="citerefentry"><span class="refentrytitle">clCreateContext</span></span></a>)  | 
 |             <code class="constant">CL_CONTEXT_TERMINATE_KHR</code>  | 
 |             can be specified in the context properties only if all devices | 
 |             associated with the context support the ability  | 
 |             to support context termination (i.e.  | 
 |             <code class="constant">CL_DEVICE_TERMINATE_CAPABILITY_CONTEXT_KHR</code>  | 
 |             is set for | 
 |             <code class="constant">CL_DEVICE_TERMINATE_CAPABILITY_KHR</code>).  | 
 |             Otherwise, context creation fails with error  | 
 |             code of <span class="errorname">CL_INVALID_PROPERTY</span>. | 
 |         </p> | 
 |       </div> | 
 |       <div class="refsect1"> | 
 |         <a id="errors"></a> | 
 |         <h2>Errors</h2> | 
 |         <p> | 
 |           <code class="function">clTerminateContextKHR</code> returns <span class="errorname">CL_SUCCESS</span>  | 
 |             if the function is executed successfully. | 
 |             Otherwise, it returns one of the following errors: | 
 |         </p> | 
 |         <div class="itemizedlist"> | 
 |           <ul class="itemizedlist" style="list-style-type: disc; "> | 
 |             <li class="listitem" style="list-style-type: disc"><span class="errorname">CL_INVALID_CONTEXT</span> if <code class="varname">context</code> is not a valid OpenCL context. | 
 |             </li> | 
 |             <li class="listitem" style="list-style-type: disc"><span class="errorname">CL_CONTEXT_TERMINATED_KHR</span> if <code class="varname">context</code> has already been terminated. | 
 |             </li> | 
 |             <li class="listitem" style="list-style-type: disc"><span class="errorname">CL_INVALID_OPERATION</span> if  | 
 |                 <code class="varname">context</code> was not created with  | 
 |                 <code class="constant">CL_CONTEXT_TERMNATE_KHR</code>  | 
 |                 set to <code class="constant">CL_TRUE</code>. | 
 |             </li> | 
 |             <li class="listitem" style="list-style-type: disc"><span class="errorname">CL_OUT_OF_RESOURCES</span> if there  | 
 |                 is a failure to allocate resources required by the | 
 |                 OpenCL implementation on the device. | 
 |             </li> | 
 |             <li class="listitem" style="list-style-type: disc"><span class="errorname">CL_OUT_OF_HOST_MEMORY</span> if there  | 
 |                 is a failure to allocate resources required by the | 
 |                 OpenCL implementation on the host. | 
 |             </li> | 
 |           </ul> | 
 |         </div> | 
 |       </div> | 
 |       <div class="refsect1"> | 
 |         <a id="specification"></a> | 
 |         <h2>Specification</h2> | 
 |         <p> | 
 |             <img src="pdficon_small1.gif" /> | 
 |  | 
 |             <a href="https://www.khronos.org/registry/cl/specs/opencl-2.0-extensions.pdf#page=123" target="OpenCL Spec">OpenCL Specification</a> | 
 |         </p> | 
 |       </div> | 
 |       <div class="refsect1"> | 
 |         <a id="seealso"></a> | 
 |         <h2>Also see</h2> | 
 |         <p> | 
 |         </p> | 
 |       </div> | 
 |       <div xmlns="" class="refsect3" lang="en" xml:lang="en"><a xmlns="http://www.w3.org/1999/xhtml" id="Copyright"></a><h4 xmlns="http://www.w3.org/1999/xhtml"></h4><img xmlns="http://www.w3.org/1999/xhtml" src="KhronosLogo.jpg" /><p xmlns="http://www.w3.org/1999/xhtml"></p>Copyright © 2007-2013 The Khronos Group Inc. | 
 | Permission is hereby granted, free of charge, to any person obtaining a | 
 | copy of this software and/or associated documentation files (the | 
 | "Materials"), to deal in the Materials without restriction, including | 
 | without limitation the rights to use, copy, modify, merge, publish, | 
 | distribute, sublicense, and/or sell copies of the Materials, and to | 
 | permit persons to whom the Materials are furnished to do so, subject to | 
 | the condition that this copyright notice and permission notice shall be included | 
 | in all copies or substantial portions of the Materials. | 
 | </div> | 
 |     </div> | 
 |   </body> | 
 | </html> |