VK_NV_device_diagnostic_checkpoints

Other Extension Metadata

Last Modified Date

2018-07-16

Contributors

• Oleg Kuznetsov, NVIDIA
• Alex Dunn, NVIDIA
• Jeff Bolz, NVIDIA
• Eric Werness, NVIDIA
• Daniel Koch, NVIDIA

Description

This extension allows applications to insert markers in the command stream and associate them with custom data.

If a device lost error occurs, the application may then query the implementation for the last markers to cross specific implementation-defined pipeline stages, in order to narrow down which commands were executing at the time and might have caused the failure.

New Commands

• vkCmdSetCheckpointNV
• vkGetQueueCheckpointDataNV

If Vulkan Version 1.3 or VK_KHR_synchronization2 is supported:

• vkGetQueueCheckpointData2NV

New Structures

• VkCheckpointDataNV
• Extending VkQueueFamilyProperties2:
  • VkQueueFamilyCheckpointPropertiesNV

If Vulkan Version 1.3 or VK_KHR_synchronization2 is supported:

• VkCheckpointData2NV
• Extending VkQueueFamilyProperties2:
  • VkQueueFamilyCheckpointProperties2NV

New Enum Constants

• VK_NV_DEVICE_DIAGNOSTIC_CHECKPOINTS_EXTENSION_NAME
• VK_NV_DEVICE_DIAGNOSTIC_CHECKPOINTS_SPEC_VERSION
• Extending VkStructureType:
  • VK_STRUCTURE_TYPE_CHECKPOINT_DATA_NV
  • VK_STRUCTURE_TYPE_QUEUE_FAMILY_CHECKPOINT_PROPERTIES_NV

If Vulkan Version 1.3 or VK_KHR_synchronization2 is supported:

• Extending VkStructureType:
  • VK_STRUCTURE_TYPE_CHECKPOINT_DATA_2_NV
  • VK_STRUCTURE_TYPE_QUEUE_FAMILY_CHECKPOINT_PROPERTIES_2_NV

Version History

• Revision 1, 2018-07-16 (Nuno Subtil)
  • Internal revisions
• Revision 2, 2018-07-16 (Nuno Subtil)
  • ???