C Specification
To specify the values to use when waiting for and signaling semaphores
created with a VkSemaphoreTypeKHR of
VK_SEMAPHORE_TYPE_TIMELINE_KHR
, add the
VkTimelineSemaphoreSubmitInfoKHR structure to the pNext
chain of
the VkSubmitInfo structure when using vkQueueSubmit or the
VkBindSparseInfo structure when using vkQueueBindSparse.
The VkTimelineSemaphoreSubmitInfoKHR
structure is defined as:
typedef struct VkTimelineSemaphoreSubmitInfoKHR {
VkStructureType sType;
const void* pNext;
uint32_t waitSemaphoreValueCount;
const uint64_t* pWaitSemaphoreValues;
uint32_t signalSemaphoreValueCount;
const uint64_t* pSignalSemaphoreValues;
} VkTimelineSemaphoreSubmitInfoKHR;
Members
-
sType
is the type of this structure. -
pNext
isNULL
or a pointer to an extension-specific structure. -
waitSemaphoreValueCount
is the number of semaphore wait values specified inpWaitSemaphoreValues
. -
pWaitSemaphoreValues
is an array of lengthwaitSemaphoreValueCount
containing values for the corresponding semaphores in VkSubmitInfo::pWaitSemaphores
to wait for. -
signalSemaphoreValueCount
is the number of semaphore signal values specified inpSignalSemaphoreValues
. -
pSignalSemaphoreValues
is an array of lengthsignalSemaphoreValueCount
containing values for the corresponding semaphores in VkSubmitInfo::pSignalSemaphores
to set when signaled.
Description
If the semaphore in VkSubmitInfo::pWaitSemaphores
or
VkSubmitInfo::pSignalSemaphores
corresponding to an entry in
pWaitSemaphoreValues
or pSignalSemaphoreValues
respectively was
not created with a VkSemaphoreTypeKHR of
VK_SEMAPHORE_TYPE_TIMELINE_KHR
, the implementation must ignore the
value in the pWaitSemaphoreValues
or pSignalSemaphoreValues
entry.
See Also
Document Notes
For more information, see the Vulkan Specification
This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.
Copyright
Copyright (c) 2014-2019 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.