Google Git
Sign in
skia / external / github.com / KhronosGroup / OpenCL-Registry / 21d94be761c3903d04ade641cd6afaed9cbb63fb / . / sdk / 1.0 / docs / man / xhtml / errors.html
blob: 138644e9b68c862982437d3807a3657fa079dfe2 [file] [log] [blame]
<?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>Errors</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
<meta name="keywords" content="Errors" />
</head>
<body>
<div class="refentry">
<a id="idm1"></a>
<div class="titlepage"></div>
<div xmlns="" class="refnamediv">
<a xmlns="http://www.w3.org/1999/xhtml" id="Errors"></a>
<h1>Errors</h1>
<p>Following are the errors encountered in OpenCL. For descriptions of errors as they pertain to specific functions, refer to the reference pages for those functions.</p>
</div>
<div class="refsect1">
<a id="synopsis"></a>
<h2></h2>
<div class="informaltable">
<div class="caption"></div>
<table class="informaltable" border="1">
<colgroup>
<col align="left" class="col1" />
<col align="left" class="col2" />
</colgroup>
<thead>
<tr>
<th align="left">Error</th>
<th align="left">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">
<code class="constant">CL_BUILD_PROGRAM_FAILURE</code>
</td>
<td align="left">
<p>
Returned by <a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a> if there is a failure to build the program executable. This error will be returned if <code class="function">clBuildProgram</code> does not return until the build has completed.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_COMPILER_NOT_AVAILABLE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a> if the parameter <code class="varname">program</code> is created with <code class="function">clCreateProgramWithSource</code> and a compiler is not available. For example <code class="constant">CL_DEVICE_COMPILER_AVAILABLE</code> is set to <code class="constant">CL_FALSE</code>.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_DEVICE_NOT_AVAILABLE</code>
</td>
<td align="left">
<p>
Returned by <a class="citerefentry" href="clCreateContext.html"><span class="citerefentry"><span class="refentrytitle">clCreateContext</span></span></a> and <a class="citerefentry" href="clCreateContextFromType.html"><span class="citerefentry"><span class="refentrytitle">clCreateContextFromType</span></span></a> if the specified device is not currently available.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_DEVICE_NOT_FOUND</code>
</td>
<td align="left">
<p>
Returned by <a class="citerefentry" href="clGetDeviceIDs.html"><span class="citerefentry"><span class="refentrytitle">clGetDeviceIDs</span></span></a> and
<a class="citerefentry" href="clCreateContextFromType.html"><span class="citerefentry"><span class="refentrytitle">clCreateContextFromType</span></span></a> if no OpenCL devices that match the specified devices were found.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_IMAGE_FORMAT_MISMATCH</code>
</td>
<td align="left">
<p>
Returned by <a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a> if the specified source and destination images are not valid image objects.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_IMAGE_FORMAT_NOT_SUPPORTED</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a> and <a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a> if the specified image format is not supported.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_ARG_INDEX</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clSetKernelArg.html"><span class="citerefentry"><span class="refentrytitle">clSetKernelArg</span></span></a> if an invalid argument index is specified.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_ARG_SIZE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clSetKernelArg.html"><span class="citerefentry"><span class="refentrytitle">clSetKernelArg</span></span></a> if argument size specified (<code class="varname">arg_size</code>) does not match the size of the data type for an argument that is not a memory object, or if the argument is a memory object and <code class="varname">arg_size</code> != <code class="constant">sizeof(cl_mem)</code> or if <code class="varname">arg_size</code> is zero and the argument is declared with the <code class="constant">__local</code> qualifier or if the argument is a sampler and <code class="varname">arg_size</code> != <code class="constant">sizeof(cl_sampler)</code>.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_ARG_VALUE</code>
</td>
<td align="left">
<p>
Returned by <a class="citerefentry" href="clSetKernelArg.html"><span class="citerefentry"><span class="refentrytitle">clSetKernelArg</span></span></a> if the argument value specified is NULL for an argument that is not declared with the <code class="constant">__local</code> qualifier or vice-versa.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_BINARY</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a> and <a class="citerefentry" href="clCreateProgramWithBinary.html"><span class="citerefentry"><span class="refentrytitle">clCreateProgramWithBinary</span></span></a> if the program binary is not a valid binary for the specified device.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_BUFFER_SIZE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateBuffer</span></span></a> if the value of the parameter <code class="varname">size</code> is 0 or is greater than CL_DEVICE_MAX_MEM_ALLOC_SIZE for all devices specified in the parameter <code class="varname">context</code>.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_BUILD_OPTIONS</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a> if the specified build options are invalid.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_COMMAND_QUEUE</code>
</td>
<td align="left">
<p>Returned by the functions listed below if the specified command-queue is not a valid command-queue. The exact condition that generates this error depends on the calling function. Refer to the function for more information.
</p><p>
Returned by the following functions: <a class="citerefentry" href="clRetainCommandQueue.html"><span class="citerefentry"><span class="refentrytitle">clRetainCommandQueue</span></span></a>, <a class="citerefentry" href="clReleaseCommandQueue.html"><span class="citerefentry"><span class="refentrytitle">clReleaseCommandQueue</span></span></a>, <a class="citerefentry" href="clGetCommandQueueInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetCommandQueueInfo</span></span></a>, <a class="citerefentry" href="clSetCommandQueueProperty.html"><span class="citerefentry"><span class="refentrytitle">clSetCommandQueueProperty</span></span></a>, <a class="citerefentry" href="clEnqueueReadBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueWriteBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueCopyBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueReadImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadImage</span></span></a>, <a class="citerefentry" href="clEnqueueWriteImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteImage</span></span></a>, <a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>, <a class="citerefentry" href="clEnqueueCopyImageToBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImageToBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueCopyBufferToImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBufferToImage</span></span></a>, <a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a>, <a class="citerefentry" href="clEnqueueUnmapMemObject.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueUnmapMemObject</span></span></a>, <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a>, <a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a>, <a class="citerefentry" href="clEnqueueNativeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNativeKernel</span></span></a>,
<a class="citerefentry" href="clEnqueueMarker.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMarker</span></span></a>, <a class="citerefentry" href="clEnqueueWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWaitForEvents</span></span></a>, <a class="citerefentry" href="clEnqueueBarrier.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueBarrier</span></span></a>, <a class="citerefentry" href="clFlush.html"><span class="citerefentry"><span class="refentrytitle">clFlush</span></span></a>, <a class="citerefentry" href="clFinish.html"><span class="citerefentry"><span class="refentrytitle">clFinish</span></span></a>,
<a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a>, and <a class="citerefentry" href="clEnqueueReleaseGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReleaseGLObjects</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_CONTEXT</code>
</td>
<td align="left"><p>Returned by the functions listed below if the specified context is not a valid OpenCL context, or the context associated with certain parameters are not the same. The exact condition that generates this error depends on the calling function. Refer to the function for more information.
</p>
<p>
Returned by the following functions: <a class="citerefentry" href="clRetainContext.html"><span class="citerefentry"><span class="refentrytitle">clRetainContext</span></span></a>, <a class="citerefentry" href="clReleaseContext.html"><span class="citerefentry"><span class="refentrytitle">clReleaseContext</span></span></a>, <a class="citerefentry" href="clGetContextInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetContextInfo</span></span></a>, <a class="citerefentry" href="clCreateCommandQueue.html"><span class="citerefentry"><span class="refentrytitle">clCreateCommandQueue</span></span></a>, <a class="citerefentry" href="clCreateBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueReadBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueWriteBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueCopyBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBuffer</span></span></a>,
<a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a>, <a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a>,
<a class="citerefentry" href="clGetSupportedImageFormats.html"><span class="citerefentry"><span class="refentrytitle">clGetSupportedImageFormats</span></span></a>, <a class="citerefentry" href="clEnqueueReadImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadImage</span></span></a>, <a class="citerefentry" href="clEnqueueWriteImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>, <a class="citerefentry" href="clEnqueueCopyImageToBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImageToBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBufferToImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBufferToImage</span></span></a>, <a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a>, <a class="citerefentry" href="clEnqueueUnmapMemObject.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueUnmapMemObject</span></span></a>,
<a class="citerefentry" href="clCreateSampler.html"><span class="citerefentry"><span class="refentrytitle">clCreateSampler</span></span></a>, <a class="citerefentry" href="clCreateProgramWithSource.html"><span class="citerefentry"><span class="refentrytitle">clCreateProgramWithSource</span></span></a>,
<a class="citerefentry" href="clCreateProgramWithBinary.html"><span class="citerefentry"><span class="refentrytitle">clCreateProgramWithBinary</span></span></a>, <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a>, <a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a>, <a class="citerefentry" href="clEnqueueNativeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNativeKernel</span></span></a>,
<a class="citerefentry" href="clWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clWaitForEvents</span></span></a>, <a class="citerefentry" href="clEnqueueWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWaitForEvents</span></span></a>,
<a class="citerefentry" href="clCreateFromGLBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLBuffer</span></span></a>, <a class="citerefentry" href="clCreateFromGLTexture2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture2D</span></span></a>, <a class="citerefentry" href="clCreateFromGLTexture3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture3D</span></span></a>, <a class="citerefentry" href="clCreateFromGLRenderbuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLRenderbuffer</span></span></a>, <a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a>, and <a class="citerefentry" href="clEnqueueReleaseGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReleaseGLObjects</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_DEVICE</code>
</td>
<td align="left">
<p>Returned by the functions listed below if the device or devices specified are not valid. The exact condition that generates this error depends on the calling function. Refer to the function for more information. </p>
<p>Returned by the following functions:
<a class="citerefentry" href="clGetDeviceIDs.html"><span class="citerefentry"><span class="refentrytitle">clGetDeviceIDs</span></span></a>,
<a class="citerefentry" href="clGetDeviceInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetDeviceInfo</span></span></a>,
<a class="citerefentry" href="clCreateContext.html"><span class="citerefentry"><span class="refentrytitle">clCreateContext</span></span></a>,
<a class="citerefentry" href="clCreateContextFromType.html"><span class="citerefentry"><span class="refentrytitle">clCreateContextFromType</span></span></a>,
<a class="citerefentry" href="clCreateCommandQueue.html"><span class="citerefentry"><span class="refentrytitle">clCreateCommandQueue</span></span></a>,
<a class="citerefentry" href="clCreateProgramWithBinary.html"><span class="citerefentry"><span class="refentrytitle">clCreateProgramWithBinary</span></span></a>,
<a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a>,
<a class="citerefentry" href="clGetProgramBuildInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetProgramBuildInfo</span></span></a>, and
<a class="citerefentry" href="clGetKernelWorkGroupInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetKernelWorkGroupInfo</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_DEVICE_TYPE</code>
</td>
<td align="left"><p>Returned by <a class="citerefentry" href="clGetDeviceIDs.html"><span class="citerefentry"><span class="refentrytitle">clGetDeviceIDs</span></span></a> and
<a class="citerefentry" href="clCreateContextFromType.html"><span class="citerefentry"><span class="refentrytitle">clCreateContextFromType</span></span></a> if device type specified is not valid.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_EVENT</code>
</td>
<td align="left">
<p>Returned by the functions listed below if the event objects specified are not valid. The exact condition that generates this error depends on the calling function. Refer to the function for more information.
</p>
<p>
Returned by the following functions: <a class="citerefentry" href="clWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clWaitForEvents</span></span></a>, <a class="citerefentry" href="clGetEventInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetEventInfo</span></span></a>,
<a class="citerefentry" href="clRetainEvent.html"><span class="citerefentry"><span class="refentrytitle">clRetainEvent</span></span></a>, <a class="citerefentry" href="clReleaseEvent.html"><span class="citerefentry"><span class="refentrytitle">clReleaseEvent</span></span></a>, <a class="citerefentry" href="clEnqueueWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWaitForEvents</span></span></a>, and
<a class="citerefentry" href="clGetEventProfilingInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetEventProfilingInfo</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_EVENT_WAIT_LIST</code>
</td>
<td align="left">
<p>Returned by the functions listed below if <code class="varname">event_wait_list</code> is <code class="constant">NULL</code> and <code class="varname">num_events_in_wait_list</code> &gt; 0, or <code class="varname">event_wait_list_list</code> is not NULL and <code class="varname">num_events_in_wait_list</code> is 0, or specified event objects are not valid events. The exact condition that generates this error depends on the calling function. Refer to the function for more information.
</p>
<p>
Returned by the following functions: <a class="citerefentry" href="clEnqueueReadBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueWriteBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueReadImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadImage</span></span></a>, <a class="citerefentry" href="clEnqueueWriteImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>, <a class="citerefentry" href="clEnqueueCopyImageToBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImageToBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBufferToImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBufferToImage</span></span></a>,
<a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a>,
<a class="citerefentry" href="clEnqueueUnmapMemObject.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueUnmapMemObject</span></span></a>,
<a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a>,
<a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>, <a class="citerefentry" href="clEnqueueCopyImageToBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImageToBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBufferToImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBufferToImage</span></span></a>,
<a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a>, <a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a>,
<a class="citerefentry" href="clEnqueueUnmapMemObject.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueUnmapMemObject</span></span></a>, <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a>,
<a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a>, and
<a class="citerefentry" href="clEnqueueReleaseGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReleaseGLObjects</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_GL_OBJECT</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateFromGLBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLBuffer</span></span></a> if <code class="varname">bufobj</code> is not a GL buffer object or is a GL buffer object but does not have an existing data store.</p>
<p>Returned by <a class="citerefentry" href="clCreateFromGLRenderbuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLRenderbuffer</span></span></a> if <code class="varname">renderbuffer</code> is not a GL renderbuffer object or if the width
or height of <code class="varname">renderbuffer</code> is zero.</p>
<p>Returned by <a class="citerefentry" href="clCreateFromGLTexture2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture2D</span></span></a> and <a class="citerefentry" href="clCreateFromGLTexture3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture3D</span></span></a> if <code class="varname">texture</code> is not a GL texture object whose type matches <code class="varname">texture_target</code>, if the specified miplevel of <code class="varname">texture</code> is not defined, or if the width, height or depth of the specified miplevel is zero.</p>
<p>Returned by <a class="citerefentry" href="clGetGLObjectInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetGLObjectInfo</span></span></a> and <a class="citerefentry" href="clGetGLTextureInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetGLTextureInfo</span></span></a> if there is no GL object or texture associated with <code class="varname">memobj</code>.</p>
<p>Returned by <a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a> and <a class="citerefentry" href="clEnqueueReleaseGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReleaseGLObjects</span></span></a> if memory objects in <code class="varname">mem_objects</code> have not been created from a GL object(s). The exact condition that generates this error depends on the calling function. </p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_GLOBAL_OFFSET</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a> if <code class="varname">global_work_offset</code> is not NULL.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_HOST_PTR</code>
</td>
<td align="left"><p>Returned by the functions listed below if <code class="varname">host_ptr</code> is NULL and <code class="constant">CL_MEM_USE_HOST_PTR</code> or <code class="constant">CL_MEM_COPY_HOST_PTR</code> are set in <code class="varname">flags</code> or if <code class="varname"> host_ptr</code> is not <code class="constant">NULL</code> but <code class="constant">CL_MEM_COPY_HOST_PTR</code> or <code class="constant">CL_MEM_USE_HOST_PTR</code> are not set in flags. The exact condition that generates this error depends on the calling function. Refer to the function for more information. </p>
<p>Returned by the functions
<a class="citerefentry" href="clCreateBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateBuffer</span></span></a>, <a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a>, and
<a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a>.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_IMAGE_FORMAT_DESCRIPTOR</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a> and
<a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a> if the image format specified is not valid or is NULL.</p>
<p>Returned by<a class="citerefentry" href="clCreateFromGLTexture2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture2D</span></span></a> and <a class="citerefentry" href="clCreateFromGLTexture3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture3D</span></span></a>
</p>
<p>Returned by <a class="citerefentry" href="clCreateFromGLRenderbuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLRenderbuffer</span></span></a> if the OpenGL renderbuffer internal format does not map to a supported OpenCL image format.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_IMAGE_SIZE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a> if the specified image width or height are 0 or if they exceed values specified in <code class="constant">CL_DEVICE_IMAGE2D_MAX_WIDTH</code> or <code class="constant">CL_DEVICE_IMAGE2D_MAX_HEIGHT</code> respectively for all devices in context, or if the specified image row pitch does not follow rules described for <code class="function">clCreateImage2D</code>.
</p>
<p>Returned by <a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a> if the specified image width or height are 0 or if the image depth is &lt;= 1, or if they exceed values specified in CL_DEVICE_IMAGE3D_MAX_WIDTH, <code class="constant">CL_DEVICE_IMAGE3D_MAX_HEIGHT</code> or <code class="constant">CL_DEVICE_IMAGE3D_MAX_DEPTH</code> respectively for all devices in context, or if the image row pitch and image slice pitch do not follow rules described for <code class="function">clCreateImage3D</code>.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_KERNEL_NAME</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateKernel.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernel</span></span></a> if the specified kernel name is not found in <code class="varname">program</code>.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_KERNEL</code>
</td>
<td align="left"><p>Returned by the functions listed below if the specified kernel is not a valid kernel object. The exact condition that generates this error depends on the calling function. Refer to the function for more information.</p>
<p>Returned by the following functions:
<a class="citerefentry" href="clReleaseKernel.html"><span class="citerefentry"><span class="refentrytitle">clReleaseKernel</span></span></a>,
<a class="citerefentry" href="clRetainKernel.html"><span class="citerefentry"><span class="refentrytitle">clRetainKernel</span></span></a>,
<a class="citerefentry" href="clSetKernelArg.html"><span class="citerefentry"><span class="refentrytitle">clSetKernelArg</span></span></a>,
<a class="citerefentry" href="clGetKernelInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetKernelInfo</span></span></a>,
<a class="citerefentry" href="clGetKernelWorkGroupInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetKernelWorkGroupInfo</span></span></a>,
<a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a>, and
<a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_KERNEL_ARGS</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a> and
<a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a> if the kernel argument values have not been specified. </p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_KERNEL_DEFINITION</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateKernel.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernel</span></span></a> if the function definition for <code class="constant">__kernel</code> function given by <code class="varname">kernel_name</code> such as the number of arguments, the argument types are not the same for all devices for which the <code class="varname">program</code> executable has been built.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_MEM_OBJECT</code>
</td>
<td align="left">
<p>Returned by the functions listed below if a parameter is not a valid memory, image, or buffer object. The exact condition that generates this error depends on the calling function. Refer to the function for more information.</p>
<p>Returned by the following functions:
<a class="citerefentry" href="clEnqueueReadBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueWriteBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBuffer</span></span></a>,
<a class="citerefentry" href="clRetainMemObject.html"><span class="citerefentry"><span class="refentrytitle">clRetainMemObject</span></span></a>,
<a class="citerefentry" href="clReleaseMemObject.html"><span class="citerefentry"><span class="refentrytitle">clReleaseMemObject</span></span></a>,
<a class="citerefentry" href="clEnqueueReadImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadImage</span></span></a>,
<a class="citerefentry" href="clEnqueueWriteImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImageToBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImageToBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBufferToImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBufferToImage</span></span></a>,
<a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a>,
<a class="citerefentry" href="clEnqueueUnmapMemObject.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueUnmapMemObject</span></span></a>,
<a class="citerefentry" href="clGetMemObjectInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetMemObjectInfo</span></span></a>,
<a class="citerefentry" href="clGetImageInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetImageInfo</span></span></a>,
<a class="citerefentry" href="clSetKernelArg.html"><span class="citerefentry"><span class="refentrytitle">clSetKernelArg</span></span></a>,
<a class="citerefentry" href="clEnqueueNativeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNativeKernel</span></span></a>,
<a class="citerefentry" href="clGetGLObjectInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetGLObjectInfo</span></span></a>,
<a class="citerefentry" href="clGetGLTextureInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetGLTextureInfo</span></span></a>,
<a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a>, and
<a class="citerefentry" href="clEnqueueReleaseGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReleaseGLObjects</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_OPERATION</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a>,
<a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a>, and
<a class="citerefentry" href="clCreateSampler.html"><span class="citerefentry"><span class="refentrytitle">clCreateSampler</span></span></a> if there are no devices in <code class="varname">context</code> that support images.
</p>
<p>Returned by <a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a> if the build of a program executable for any of the devices specified by a previous call to <code class="function">clBuildProgram</code> for <code class="varname">program</code> has not completed, or if there are kernel objects attached to <code class="varname">program</code>.
</p>
<p>Returned by <a class="citerefentry" href="clEnqueueNativeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNativeKernel</span></span></a> if the specified device cannot execute the native kernel.
</p>
<p>Returned by <a class="citerefentry" href="clCreateFromGLTexture2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture2D</span></span></a> if the miplevel is less than 0.
</p>
<p>Returned by <a class="citerefentry" href="clCreateFromGLTexture3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture3D</span></span></a> if 3D images are not supported by the OpenCL embedded profile.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_PLATFORM</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clGetPlatformInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetPlatformInfo</span></span></a> and
<a class="citerefentry" href="clGetDeviceIDs.html"><span class="citerefentry"><span class="refentrytitle">clGetDeviceIDs</span></span></a> if the specified platform is not a valid platform.
</p>
<p>Returned by <a class="citerefentry" href="clCreateContext.html"><span class="citerefentry"><span class="refentrytitle">clCreateContext</span></span></a> and
<a class="citerefentry" href="clCreateContextFromType.html"><span class="citerefentry"><span class="refentrytitle">clCreateContextFromType</span></span></a> if <code class="varname">properties</code> is NULL and no platform could be selected, or if platform value specified in <code class="varname">properties</code> is not a valid platform.</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_PROGRAM</code>
</td>
<td align="left"><p>Returned by the functions listed below if the specified program is not a valid program object. The exact condition that generates this error depends on the calling function. Refer to the function for more information. </p>
<p>Returned by the following functions:
<a class="citerefentry" href="clRetainProgram.html"><span class="citerefentry"><span class="refentrytitle">clRetainProgram</span></span></a>,
<a class="citerefentry" href="clReleaseProgram.html"><span class="citerefentry"><span class="refentrytitle">clReleaseProgram</span></span></a>,
<a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a>,
<a class="citerefentry" href="clGetProgramInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetProgramInfo</span></span></a>,
<a class="citerefentry" href="clGetProgramBuildInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetProgramBuildInfo</span></span></a>,
<a class="citerefentry" href="clCreateKernel.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernel</span></span></a>, and
<a class="citerefentry" href="clCreateKernelsInProgram.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernelsInProgram</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_PROGRAM_EXECUTABLE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateKernel.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernel</span></span></a> if there is no successfully built executable for <code class="varname">program</code>, and returned by
<a class="citerefentry" href="clCreateKernelsInProgram.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernelsInProgram</span></span></a> if there is no device in <code class="varname">program</code>.
</p>
<p>Returned by <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a> and <a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a> if there is no successfully built program executable available for device associated with <code class="varname">command_queue</code>.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_QUEUE_PROPERTIES</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clCreateCommandQueue.html"><span class="citerefentry"><span class="refentrytitle">clCreateCommandQueue</span></span></a> and <a class="citerefentry" href="clSetCommandQueueProperty.html"><span class="citerefentry"><span class="refentrytitle">clSetCommandQueueProperty</span></span></a> if specified properties are valid but are not supported by the device.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_SAMPLER</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clRetainSampler.html"><span class="citerefentry"><span class="refentrytitle">clRetainSampler</span></span></a>, <a class="citerefentry" href="clReleaseSampler.html"><span class="citerefentry"><span class="refentrytitle">clReleaseSampler</span></span></a>, and
<a class="citerefentry" href="clGetSamplerInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetSamplerInfo</span></span></a> if the specified sampler is not a valid sampler object.
</p>
<p>Returned by <a class="citerefentry" href="clSetKernelArg.html"><span class="citerefentry"><span class="refentrytitle">clSetKernelArg</span></span></a> for an argument declared to be of type sampler_t when the specified <code class="varname">arg_value</code> is not a valid sampler object.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_VALUE</code>
</td>
<td align="left"><p>Returned by the functions listed below if a parameter is not an expected value. The exact condition that generates this error depends on the calling function. Refer to the function for more information.</p>
<p>Returned by the following functions:
<a class="citerefentry" href="clGetPlatformIDs.html"><span class="citerefentry"><span class="refentrytitle">clGetPlatformIDs</span></span></a>,
<a class="citerefentry" href="clGetPlatformInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetPlatformInfo</span></span></a>,
<a class="citerefentry" href="clGetDeviceIDs.html"><span class="citerefentry"><span class="refentrytitle">clGetDeviceIDs</span></span></a>,
<a class="citerefentry" href="clGetDeviceInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetDeviceInfo</span></span></a>,
<a class="citerefentry" href="clCreateContext.html"><span class="citerefentry"><span class="refentrytitle">clCreateContext</span></span></a>,
<a class="citerefentry" href="clCreateContextFromType.html"><span class="citerefentry"><span class="refentrytitle">clCreateContextFromType</span></span></a>,
<a class="citerefentry" href="clGetContextInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetContextInfo</span></span></a>,
<a class="citerefentry" href="clCreateCommandQueue.html"><span class="citerefentry"><span class="refentrytitle">clCreateCommandQueue</span></span></a>,
<a class="citerefentry" href="clGetCommandQueueInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetCommandQueueInfo</span></span></a>,
<a class="citerefentry" href="clSetCommandQueueProperty.html"><span class="citerefentry"><span class="refentrytitle">clSetCommandQueueProperty</span></span></a>,
<a class="citerefentry" href="clCreateBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueReadBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueWriteBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBuffer</span></span></a>,
<a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a>,
<a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a>,
<a class="citerefentry" href="clGetSupportedImageFormats.html"><span class="citerefentry"><span class="refentrytitle">clGetSupportedImageFormats</span></span></a>,
<a class="citerefentry" href="clEnqueueReadImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadImage</span></span></a>,
<a class="citerefentry" href="clEnqueueWriteImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImageToBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImageToBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBufferToImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBufferToImage</span></span></a>,
<a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a>,
<a class="citerefentry" href="clEnqueueUnmapMemObject.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueUnmapMemObject</span></span></a>,
<a class="citerefentry" href="clGetMemObjectInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetMemObjectInfo</span></span></a>,
<a class="citerefentry" href="clGetImageInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetImageInfo</span></span></a>,
<a class="citerefentry" href="clCreateSampler.html"><span class="citerefentry"><span class="refentrytitle">clCreateSampler</span></span></a>,
<a class="citerefentry" href="clGetSamplerInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetSamplerInfo</span></span></a>,
<a class="citerefentry" href="clCreateProgramWithSource.html"><span class="citerefentry"><span class="refentrytitle">clCreateProgramWithSource</span></span></a>,
<a class="citerefentry" href="clCreateProgramWithBinary.html"><span class="citerefentry"><span class="refentrytitle">clCreateProgramWithBinary</span></span></a>,
<a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a>,
<a class="citerefentry" href="clGetProgramInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetProgramInfo</span></span></a>,
<a class="citerefentry" href="clGetProgramBuildInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetProgramBuildInfo</span></span></a>,
<a class="citerefentry" href="clCreateKernel.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernel</span></span></a>,
<a class="citerefentry" href="clCreateKernelsInProgram.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernelsInProgram</span></span></a>,
<a class="citerefentry" href="clGetKernelInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetKernelInfo</span></span></a>,
<a class="citerefentry" href="clGetKernelWorkGroupInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetKernelWorkGroupInfo</span></span></a>,
<a class="citerefentry" href="clEnqueueNativeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNativeKernel</span></span></a>,
<a class="citerefentry" href="clWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clWaitForEvents</span></span></a>,
<a class="citerefentry" href="clGetEventInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetEventInfo</span></span></a>,
<a class="citerefentry" href="clEnqueueMarker.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMarker</span></span></a>,
<a class="citerefentry" href="clEnqueueWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWaitForEvents</span></span></a>,
<a class="citerefentry" href="clGetEventProfilingInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetEventProfilingInfo</span></span></a>,
<a class="citerefentry" href="clCreateFromGLBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLBuffer</span></span></a>,
<a class="citerefentry" href="clCreateFromGLTexture2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture2D</span></span></a>,
<a class="citerefentry" href="clCreateFromGLTexture3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture3D</span></span></a>,
<a class="citerefentry" href="clCreateFromGLRenderbuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLRenderbuffer</span></span></a>,
<a class="citerefentry" href="clGetGLTextureInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetGLTextureInfo</span></span></a>, and
<a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_WORK_DIMENSION</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a> if <code class="varname">work_dim</code> is not a valid value.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_WORK_GROUP_SIZE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a> and <a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a> if <code class="varname">local_work_size</code> is specified and number of workitems specified by <code class="varname">global_work_size</code> is not evenly divisible by size of work-group given by <code class="varname">local_work_size</code> or does not match the work-group size specified for <code class="varname">kernel</code> using the <code class="constant">__attribute__((reqd_work_group_size(X, Y, Z)))</code> qualifier in program source.</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_INVALID_WORK_ITEM_SIZE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a> if the number of work-items specified in any of local_work_size... [0]... local_work_size[work_dim - 1] is greater than the corresponding values specified by CL_DEVICE_MAX_WORK_ITEM_SIZES[0],... CL_DEVICE_MAX_WORK_ITEM_SIZES[work_dim -1].
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_MAP_FAILURE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a> and
<a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a> if there is a failure to map the requested region into the host address space. This error cannot occur for buffer objects created with <code class="function">CL_MEM_USE_HOST_PTR</code> or <code class="function">CL_MEM_ALLOC_HOST_PTR</code>.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_MEM_OBJECT_ALLOCATION_FAILURE</code>
</td>
<td align="left">
<p>Returned by the functions listed below if there is a failure to allocate memory for data store associated with image or buffer objects specified as arguments to <code class="varname">kernel</code>. The exact condition that generates this error depends on the calling function. Refer to the function for more information.
</p>
<p>Returned by the following functions:
<a class="citerefentry" href="clCreateBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueReadBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueWriteBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBuffer</span></span></a>,
<a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a>,
<a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a>,
<a class="citerefentry" href="clEnqueueReadImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadImage</span></span></a>,
<a class="citerefentry" href="clEnqueueWriteImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImageToBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImageToBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBufferToImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBufferToImage</span></span></a>,
<a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a>,
<a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a>,
<a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a>, and
<a class="citerefentry" href="clEnqueueNativeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNativeKernel</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_MEM_COPY_OVERLAP</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clEnqueueCopyBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBuffer</span></span></a> and <a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a> if the source and destination images are the same image (or the source and destination buffers are the same buffer), and the source and destination regions overlap.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_OUT_OF_HOST_MEMORY</code>
</td>
<td align="left">
<p>Returned by the functions listed below in the event of a failure to allocate resources required by the OpenCL implementation on the host. The exact condition that generates this error depends on the calling function. Refer to the function for more information.
</p>
<p>Returned by the following functions:
<a class="citerefentry" href="clCreateContext.html"><span class="citerefentry"><span class="refentrytitle">clCreateContext</span></span></a>,
<a class="citerefentry" href="clCreateContextFromType.html"><span class="citerefentry"><span class="refentrytitle">clCreateContextFromType</span></span></a>,
<a class="citerefentry" href="clCreateCommandQueue.html"><span class="citerefentry"><span class="refentrytitle">clCreateCommandQueue</span></span></a>,
<a class="citerefentry" href="clCreateBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBuffer</span></span></a>,
<a class="citerefentry" href="clCreateImage2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage2D</span></span></a>,
<a class="citerefentry" href="clCreateImage3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateImage3D</span></span></a>,
<a class="citerefentry" href="clEnqueueReadImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReadImage</span></span></a>,
<a class="citerefentry" href="clEnqueueWriteImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWriteImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImage</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyImageToBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyImageToBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueCopyBufferToImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueCopyBufferToImage</span></span></a>,
<a class="citerefentry" href="clEnqueueMapBuffer.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapBuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueMapImage.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMapImage</span></span></a>,
<a class="citerefentry" href="clEnqueueUnmapMemObject.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueUnmapMemObject</span></span></a>,
<a class="citerefentry" href="clCreateSampler.html"><span class="citerefentry"><span class="refentrytitle">clCreateSampler</span></span></a>,
<a class="citerefentry" href="clCreateProgramWithSource.html"><span class="citerefentry"><span class="refentrytitle">clCreateProgramWithSource</span></span></a>,
<a class="citerefentry" href="clCreateProgramWithBinary.html"><span class="citerefentry"><span class="refentrytitle">clCreateProgramWithBinary</span></span></a>,
<a class="citerefentry" href="clBuildProgram.html"><span class="citerefentry"><span class="refentrytitle">clBuildProgram</span></span></a>,
<a class="citerefentry" href="clCreateKernel.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernel</span></span></a>,
<a class="citerefentry" href="clCreateKernelsInProgram.html"><span class="citerefentry"><span class="refentrytitle">clCreateKernelsInProgram</span></span></a>,
<a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a>,
<a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a>,
<a class="citerefentry" href="clEnqueueNativeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNativeKernel</span></span></a>,
<a class="citerefentry" href="clEnqueueMarker.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueMarker</span></span></a>,
<a class="citerefentry" href="clEnqueueWaitForEvents.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueWaitForEvents</span></span></a>,
<a class="citerefentry" href="clEnqueueBarrier.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueBarrier</span></span></a>,
<a class="citerefentry" href="clFlush.html"><span class="citerefentry"><span class="refentrytitle">clFlush</span></span></a>,
<a class="citerefentry" href="clFinish.html"><span class="citerefentry"><span class="refentrytitle">clFinish</span></span></a>,
<a class="citerefentry" href="clCreateFromGLBuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLBuffer</span></span></a>,
<a class="citerefentry" href="clCreateFromGLTexture2D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture2D</span></span></a>,
<a class="citerefentry" href="clCreateFromGLTexture3D.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLTexture3D</span></span></a>,
<a class="citerefentry" href="clCreateFromGLRenderbuffer.html"><span class="citerefentry"><span class="refentrytitle">clCreateFromGLRenderbuffer</span></span></a>,
<a class="citerefentry" href="clEnqueueAcquireGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueAcquireGLObjects</span></span></a>, and
<a class="citerefentry" href="clEnqueueReleaseGLObjects.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueReleaseGLObjects</span></span></a>
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_OUT_OF_RESOURCES</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clEnqueueNDRangeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNDRangeKernel</span></span></a>,
<a class="citerefentry" href="clEnqueueTask.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueTask</span></span></a>, and
<a class="citerefentry" href="clEnqueueNativeKernel.html"><span class="citerefentry"><span class="refentrytitle">clEnqueueNativeKernel</span></span></a> in the event of a failure to queue the execution instance of <code class="varname">kernel</code> on the command-queue because of insufficient resources needed to execute the kernel.
</p>
</td>
</tr>
<tr>
<td align="left">
<code class="constant">CL_PROFILING_INFO_NOT_AVAILABLE</code>
</td>
<td align="left">
<p>Returned by <a class="citerefentry" href="clGetEventProfilingInfo.html"><span class="citerefentry"><span class="refentrytitle">clGetEventProfilingInfo</span></span></a> if the <code class="constant">CL_QUEUE_PROFILING_ENABLE</code> flag is not set for the command-queue and the profiling information is currently not available (because the command identified by <code class="varname">event</code> has not completed).
</p>
</td>
</tr>
<tr>
<td align="left">
<span class="errorname">CL_SUCCESS</span>
</td>
<td align="left"><p>Indicates that the function executed successfully.</p>
</td>
</tr>
</tbody>
</table>
</div>
</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>
Copyright ©
Copyright © 2007-2009 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>