vkCmdSetCheckpointNV - insert diagnostic checkpoint in command stream

Parameters

• commandBuffer is the command buffer that will receive the marker

• pCheckpointMarker is an opaque application-provided value that will be associated with the checkpoint.

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics, compute, or transfer operations

Host Synchronization

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

See Also

CommandBuffer

vkGetQueueCheckpointDataNV - retrieve diagnostic checkpoint data

Parameters

• queue is the Queue object the caller would like to retrieve checkpoint data for

• pCheckpointDataCount is a pointer to an integer related to the number of checkpoint markers available or queried, as described below.
• pCheckpointData is either NULL or a pointer to an array of CheckpointDataNV structures.

Description

If pCheckpointData is NULL, then the number of checkpoint markers available is returned in pCheckpointDataCount.

Otherwise, pCheckpointDataCount must point to a variable set by the user to the number of elements in the pCheckpointData array, and on return the variable is overwritten with the number of structures actually written to pCheckpointData.

If pCheckpointDataCount is less than the number of checkpoint markers available, at most pCheckpointDataCount structures will be written.

Valid Usage

• The device that queue belongs to must be in the lost state

Valid Usage (Implicit)

• queue must be a valid Queue handle

• pCheckpointDataCount must be a valid pointer to a uint32_t value
• If the value referenced by pCheckpointDataCount is not 0, and pCheckpointData is not NULL, pCheckpointData must be a valid pointer to an array of pCheckpointDataCount CheckpointDataNV structures

See Also

CheckpointDataNV, Queue

VkQueueFamilyCheckpointPropertiesNV - return structure for queue family checkpoint info query

Valid Usage (Implicit)

See Also

PipelineStageFlags, StructureType

VkCheckpointDataNV - return structure for command buffer checkpoint data

Valid Usage (Implicit)

Note that the stages at which a checkpoint marker can be executed are implementation-defined and can be queried by calling getPhysicalDeviceQueueFamilyProperties2.

See Also

PipelineStageFlagBits, StructureType, getQueueCheckpointDataNV