Skip to content

Commit 1e56bbd

Browse files
author
Ewan Crawford
authored
Clarify implementation deferal of clUpdateMutableCommandsKHR (KhronosGroup#1315)
* Clarify impl deferal of clUpdateMutableCommandsKHR Address point 1) of KhronosGroup#1309 by clarifying when an implementation may defer propogating the changes from `clUpdateMutableCommandsKHR`. I belive the only semantic implication of this is the removing the restriction > This is only possible with a command-buffer created with the CL_COMMAND_BUFFER_SIMULTANEOUS_USE_KHR flag, as without this the enqueued command-buffer must complete before any modification occurs. So that implementations without simultaneous use support can still defer. * Make change a NOTE
1 parent a2efd6b commit 1e56bbd

1 file changed

Lines changed: 7 additions & 9 deletions

File tree

api/opencl_runtime_layer.asciidoc

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16494,15 +16494,13 @@ kernel commands using that object as an argument have had their arguments
1649416494
replaced with a different object.
1649516495
====
1649616496

16497-
To facilitate performant usage for pipelined work flows, where applications
16498-
repeatedly call command-buffer update then enqueue, implementations may
16499-
defer some of the work to allow {clUpdateMutableCommandsKHR} to return
16500-
immediately.
16501-
Deferring any recompilation until {clEnqueueCommandBufferKHR} avoids
16502-
blocking in host code and keeps device occupancy high.
16503-
This is only possible with a command-buffer created with the
16504-
{CL_COMMAND_BUFFER_SIMULTANEOUS_USE_KHR} flag, as without this the enqueued
16505-
command-buffer must complete before any modification occurs.
16497+
[NOTE]
16498+
====
16499+
Implementations may defer some of the work to allow {clUpdateMutableCommandsKHR}
16500+
to return immediately, provided the user observable behavior in subsequent
16501+
command-buffer usage is specification conformant. Deferring work helps keep
16502+
device occupancy high by avoiding blocking in host code.
16503+
====
1650616504

1650716505
[open,refpage='clUpdateMutableCommandsKHR',desc='Modify configuration of mutable-command handles to update behavior for future enqueues',type='protos']
1650816506
--

0 commit comments

Comments
 (0)