C Specification
To write a 32-bit marker value into a buffer as a pipelined operation, call:
// Provided by VK_AMD_buffer_marker with VK_VERSION_1_3 or VK_KHR_synchronization2
void vkCmdWriteBufferMarker2AMD(
VkCommandBuffer commandBuffer,
VkPipelineStageFlags2 stage,
VkBuffer dstBuffer,
VkDeviceSize dstOffset,
uint32_t marker);Parameters
-
commandBufferis the command buffer into which the command will be recorded. -
stagespecifies the pipeline stage whose completion triggers the marker write. -
dstBufferis the buffer where the marker will be written. -
dstOffsetis the byte offset into the buffer where the marker will be written. -
markeris the 32-bit value of the marker.
Description
When vkCmdWriteBufferMarker2AMD is submitted to a queue, it defines an
execution dependency between prior operations and writing the marker value,
as well as a memory dependency from earlier buffer
marker write commands.
The first synchronization scope
includes operations performed by operations that occur earlier in
submission order in the pipeline stage
identified by pipelineStage.
It additionally includes other buffer marker write
commands that occur earlier in submission order that specified either the same pipelineStage or a
stage that is logically earlier.
The second synchronization scope includes only the buffer marker write.
The first access scope includes only accesses performed by other buffer marker write commands.
The second access scope is empty.
The access scope for buffer marker writes falls under the
VK_ACCESS_TRANSFER_WRITE_BIT flag, and is performed by either
pipelineStage or VK_PIPELINE_STAGE_TRANSFER_BIT.
Synchronization commands should specify this access
flag and both pipeline stages when defining dependencies with this command.
|
Note
|
Similar to |
|
Note
|
Implementations may only support a limited number of pipelined marker write operations in flight at a given time. Thus an excessive number of marker write operations may degrade command execution performance. |
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.