Skip to content

Commit bc6abc4

Browse files
authored
cl_khr_external_semaphore_dx_fence: Modify wording to reflect intent (#1362)
Adjust the wording to allow proper handling of timepoints in clEnqueueWaitSemaphore and clEnqueueSignalSemaphore
1 parent f586b25 commit bc6abc4

1 file changed

Lines changed: 7 additions & 7 deletions

File tree

api/opencl_runtime_layer.asciidoc

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13794,7 +13794,7 @@ a semaphore from an external handle:
1379413794

1379513795
* {CL_SEMAPHORE_HANDLE_D3D12_FENCE_KHR} specifies an NT handle returned by
1379613796
`ID3D12Device::CreateSharedHandle` referring to a Direct3D 12 fence, or
13797-
`ID3D11Device5::CreateFence` referring to a Direct3D 11 fence.
13797+
`ID3D11Fence::CreateSharedHandle` referring to a Direct3D 11 fence.
1379813798
It owns a reference to the underlying synchronization primitive
1379913799
associated with the Direct3D fence.
1380013800

@@ -13807,8 +13807,8 @@ be provided for semaphores created from
1380713807
{CL_SEMAPHORE_HANDLE_D3D12_FENCE_KHR} and other handle types, then the
1380813808
_sema_payload_list_ should point to a list of _num_sema_objects_ payload
1380913809
values for each semaphore in _sema_objects_.
13810-
However, the payload values corresponding to semaphores with type
13811-
{CL_SEMAPHORE_TYPE_BINARY_KHR} can be set to 0 or will be ignored.
13810+
However, the payload values corresponding to semaphores that do not require
13811+
a payload will be ignored.
1381213812

1381313813
{clEnqueueWaitSemaphoresKHR} and {clEnqueueSignalSemaphoresKHR} may return
1381413814
{CL_INVALID_VALUE} if _sema_objects_ list has one or more semaphores
@@ -13909,8 +13909,8 @@ include::{generated}/api/version-notes/clEnqueueWaitSemaphoresKHR.asciidoc[]
1390913909
* _sema_payload_list_ points to the list of values of type
1391013910
{cl_semaphore_payload_khr_TYPE} containing valid semaphore payload
1391113911
values to wait on.
13912-
This can be set to `NULL` or will be ignored when all semaphores in the
13913-
list of _sema_objects_ are of type {CL_SEMAPHORE_TYPE_BINARY_KHR}.
13912+
This can be set to `NULL` or will be ignored if no semaphores in the
13913+
list of _sema_objects_ require a payload.
1391413914
* _num_events_in_wait_list_ specifies the number of events in
1391513915
_event_wait_list_.
1391613916
* _event_wait_list_ specifies list of events that need to complete before
@@ -14006,8 +14006,8 @@ include::{generated}/api/version-notes/clEnqueueSignalSemaphoresKHR.asciidoc[]
1400614006
* _sema_payload_list_ points to the list of values of type
1400714007
{cl_semaphore_payload_khr_TYPE} containing semaphore payload values to
1400814008
signal.
14009-
This can be set to `NULL` or will be ignored when all semaphores in the
14010-
list of _sema_objects_ are of type {CL_SEMAPHORE_TYPE_BINARY_KHR}.
14009+
This can be set to `NULL` or will be ignored if no semaphores in the
14010+
list of _sema_objects_ require a payload.
1401114011
* _num_events_in_wait_list_ specifies the number of events in
1401214012
* _event_wait_list_ points to the list of events that need to complete
1401314013
before {clEnqueueSignalSemaphoresKHR} can be executed.

0 commit comments

Comments
 (0)