Skip to content

Commit 85f5032

Browse files
author
Ewan Crawford
authored
Add multi-device wording to clCommandBarrierWithWaitListKHR (KhronosGroup#1146)
`clCommandBarrierWithWaitListKHR` does not having wording for the `command_queue` parameter regarding when `cl_khr_command_buffer_multi_device` is enabled.
1 parent bed6c84 commit 85f5032

1 file changed

Lines changed: 19 additions & 5 deletions

File tree

api/opencl_runtime_layer.asciidoc

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14281,10 +14281,17 @@ include::{generated}/api/protos/clCommandBarrierWithWaitListKHR.txt[]
1428114281
include::{generated}/api/version-notes/clCommandBarrierWithWaitListKHR.asciidoc[]
1428214282

1428314283
* _command_buffer_ refers to a valid command-buffer object.
14284-
* _command_queue_ specifies the command-queue the command will be recorded
14285-
to.
14286-
This parameter is unused, as only a single
14287-
command-queue is supported, and **must** be `NULL`.
14284+
* _command_queue_ specifies the command-queue the command will be recorded to.
14285+
{empty} +
14286+
If the {cl_khr_command_buffer_multi_device_EXT} extension is not supported,
14287+
only a single command-queue is supported, and _command_queue_ must be
14288+
`NULL`.
14289+
ifdef::cl_khr_command_buffer_multi_device[]
14290+
{empty} +
14291+
If the {cl_khr_command_buffer_multi_device_EXT} extension is supported and
14292+
_command_queue_ is `NULL`, then only one command-queue must have been set on
14293+
_command_buffer_ creation; otherwise, _command_queue_ must not be `NULL`.
14294+
endif::cl_khr_command_buffer_multi_device[]
1428814295
* _sync_point_wait_list_, _num_sync_points_in_wait_list_ specify
1428914296
synchronization-points that need to complete before this particular
1429014297
command can be executed.
@@ -14332,7 +14339,14 @@ recorded after it do not execute until it completes.
1433214339
executed successfully.
1433314340
Otherwise, it returns one of the following errors:
1433414341

14335-
* {CL_INVALID_COMMAND_QUEUE} if _command_queue_ is not `NULL`.
14342+
* {CL_INVALID_COMMAND_QUEUE} if the
14343+
{cl_khr_command_buffer_multi_device_EXT} extension is not supported and
14344+
_command_queue_ is not `NULL`.
14345+
* {CL_INVALID_COMMAND_QUEUE} if the
14346+
{cl_khr_command_buffer_multi_device_EXT} extension is supported; and
14347+
either _command_queue_ is `NULL` and _command_buffer_ was created with
14348+
more than one queue, or _command_queue_ is not `NULL` and not a
14349+
command-queue listed on _command_buffer_ creation.
1433614350
* {CL_INVALID_COMMAND_BUFFER_KHR} if _command_buffer_ is not a valid
1433714351
command-buffer.
1433814352
* {CL_INVALID_CONTEXT} if the context associated with _command_queue_ and

0 commit comments

Comments
 (0)