VkTimelineSemaphoreSubmitInfo
To specify the values to use when waiting for and signaling semaphores
created with a VkSemaphoreType of VK_SEMAPHORE_TYPE_TIMELINE
,
add a VkTimelineSemaphoreSubmitInfo structure to the pNext
chain
of the VkSubmitInfo structure when using vkQueueSubmit
or the VkBindSparseInfo structure when using vkQueueBindSparse
.
The VkTimelineSemaphoreSubmitInfo
structure is defined as:
typedef struct VkTimelineSemaphoreSubmitInfo {
VkStructureType sType;
const void* pNext;
uint32_t waitSemaphoreValueCount;
const uint64_t* pWaitSemaphoreValues;
uint32_t signalSemaphoreValueCount;
const uint64_t* pSignalSemaphoreValues;
} VkTimelineSemaphoreSubmitInfo;
or the equivalent
typedef VkTimelineSemaphoreSubmitInfo VkTimelineSemaphoreSubmitInfoKHR;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.waitSemaphoreValueCount
is the number of semaphore wait values specified inpWaitSemaphoreValues
.pWaitSemaphoreValues
is a pointer to an array ofwaitSemaphoreValueCount
values for the corresponding semaphores in VkSubmitInfo::pWaitSemaphores
to wait for.signalSemaphoreValueCount
is the number of semaphore signal values specified inpSignalSemaphoreValues
.pSignalSemaphoreValues
is a pointer to an arraysignalSemaphoreValueCount
values for the corresponding semaphores in VkSubmitInfo::pSignalSemaphores
to set when signaled.
If the semaphore in VkSubmitInfo::pWaitSemaphores
or
VkSubmitInfo::pSignalSemaphores
corresponding to an entry in
pWaitSemaphoreValues
or pSignalSemaphoreValues
respectively was
not created with a VkSemaphoreType of
VK_SEMAPHORE_TYPE_TIMELINE
, the implementation must ignore the value
in the pWaitSemaphoreValues
or pSignalSemaphoreValues
entry.
Valid Usage (Implicit)
VUID-VkTimelineSemaphoreSubmitInfo-sType-sType
sType
must be VK_STRUCTURE_TYPE_TIMELINE_SEMAPHORE_SUBMIT_INFO
VUID-VkTimelineSemaphoreSubmitInfo-pWaitSemaphoreValues-parameter
If waitSemaphoreValueCount
is not 0
, and pWaitSemaphoreValues
is not NULL
, pWaitSemaphoreValues
must be a valid pointer to an array of waitSemaphoreValueCount
uint64_t
values
VUID-VkTimelineSemaphoreSubmitInfo-pSignalSemaphoreValues-parameter
If signalSemaphoreValueCount
is not 0
, and pSignalSemaphoreValues
is not NULL
, pSignalSemaphoreValues
must be a valid pointer to an array of signalSemaphoreValueCount
uint64_t
values