blob: bd1c0aa6238e9ea55b6621a49d07354d4dccb629 [file] [log] [blame]
<!-- table 5.1 - List of supported cl_queue_property values and description -->
<informaltable frame="all"><tgroup cols="2" align="left" colsep="1" rowsep="1">
<colspec colname="col1" colnum="1" />
<colspec colname="col2" colnum="2" />
<thead>
<row>
<entry>Queue Properties</entry>
<entry>Property Value</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><constant>CL_QUEUE_PROPERTIES</constant></entry>
<entry><type>cl_command_queue_-
properties</type></entry>
<entry><para>This is a bitfield and can be set to a
combination of the following values:</para>
<para><constant>CL_QUEUE_OUT_OF_ORDER_EXEC_MODE_ENABLE</constant> -
Determines whether the
commands queued in the command-queue
are executed in-order or out-of-order. If
set, the commands in the command-queue
are executed out-of-order. Otherwise,
commands are executed in-order.</para>
<para><constant>CL_QUEUE_PROFILING_ENABLE</constant> -
Enable or disable profiling of commands in
the command-queue. If set, the profiling of
commands is enabled. Otherwise profiling
of commands is disabled.</para>
<para><constant>CL_QUEUE_ON_DEVICE</constant> - Indicates that this
is a device queue. If <constant>CL_QUEUE_ON_DEVICE</constant>
is set, <constant>CL_QUEUE_OUT_OF_ORDER_EXEC_MODE_ENABLE</constant>
must also be set. Only out-of-order device queues are supported.</para>
<para><constant>CL_QUEUE_ON_DEVICE_DEFAULT</constant> -
indicates that this is the default device
queue. This can only be used with
<constant>CL_QUEUE_ON_DEVICE</constant>.
The application should create the default device queue if needed.
There can only be one default device queue per context.
<function>clCreateCommandQueueWithProperties</function>
with <constant>CL_QUEUE_PROPERTIES</constant> set to
<constant>CL_QUEUE_ON_DEVICE</constant> |
<constant>CL_QUEUE_ON_DEVICE_DEFAULT</constant>
will return the default device queue thas
already been created and increment its retain count by 1.
</para>
<para>If <constant>CL_QUEUE_PROPERTIES</constant> is not
specified an in-order host command queue
is created for the specified device.</para>
</entry>
</row>
<row>
<entry><constant>CL_QUEUE_SIZE</constant></entry>
<entry><type>cl_uint</type></entry>
<entry><para>Specifies the size of the device queue in
bytes.</para>
<para>This can only be specified if
<constant>CL_QUEUE_ON_DEVICE</constant> is set in
<constant>CL_QUEUE_PROPERTIES</constant>. This must be a
value &le; <constant>CL_DEVICE_QUEUE_ON_DEVICE_MAX_SIZE</constant>.</para>
<para>For best performance, this should be &le;
<constant>CL_DEVICE_QUEUE_ON_DEVICE_PREFERRED_SIZE</constant>.</para>
<para>If <constant>CL_QUEUE_SIZE</constant> is not specified, the
device queue is created with
<constant>CL_DEVICE_QUEUE_ON_DEVICE_PREFERRED_SIZE</constant>
as the size of the queue.</para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
<!-- 11-Dec-2013, rev. 19 -->