Vulkan-Docs/appendices/VK_NV_device_diagnostic_che...

include::meta/VK_NV_device_diagnostic_checkpoints.txt[]

*Last Modified Date*::
    2018-07-16
*Contributors*::
  - Oleg Kuznetsov, NVIDIA
  - Alex Dunn, NVIDIA
  - Jeff Bolz, NVIDIA
  - Eric Werness, NVIDIA
  - Daniel Koch, NVIDIA


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 Object Types

None.

=== New Enum Constants

Extending slink:VkStructureType:

 * ename:VK_STRUCTURE_TYPE_CHECKPOINT_DATA_NV
 * ename:VK_STRUCTURE_TYPE_QUEUE_FAMILY_CHECKPOINT_PROPERTIES_NV

=== New Enums

None.

=== New Structures

 * slink:VkCheckpointDataNV
 * slink:VkQueueFamilyCheckpointPropertiesNV

=== New Functions

 * flink:vkCmdSetCheckpointNV
 * flink:vkGetQueueCheckpointDataNV

=== Issues

None yet!


=== Version History

  * Revision 1, 2018-07-16 (Nuno Subtil)
    - Internal revisions
Change log for July 30, 2018 Vulkan 1.1.82 spec update: * Update release number to 82. Public Issues: * Add flink:vkDestroyPipelineLayout valid usage statement that the layout must not have been used with command buffers still in the recording state (public issue 730). * Correct \<unused> tag for elink:VkResult in `vk.xml` (public merge request 746). Internal Issues: * Add a valid usage statement to flink:vkQueueSubmit, and similar language to the definitions of <<synchronization-queue-transfers-acquire, acquire operations>> requiring that an acquire operation follow a previous release of the same subresource (internal issue 1290). * Add <<resources-image-format-features,Image Format Features>> and <<resources-image-view-format-features,Image View Format Features>> sections that precisely define the slink:VkFormatFeatures supported by images and image views, and rewrite valid usage statements to reference these sections instead of duplicating language (internal issue 1310). * Reword and consolidate synchronization valid usage statements for flink:vkCmdPipelineBarrier such that they correctly account for mutiple possible self-dependencies (internal issue 1322). * Change order of <<Standard sample locations>> for 2xMSAA (internal issue 1347). * Add definitions of "`<<Correctly Rounded>>`" and "`<<ULP>>`" in the SPIR-V environment appendix, and "`Units in the Last Place (ULP)`" in the glossary. New Extensions: * `VK_NV_device_diagnostic_checkpoints` 2018-07-30 10:20:00 +00:00			`include::meta/VK_NV_device_diagnostic_checkpoints.txt[]`

			`Last Modified Date::`
			`2018-07-16`
			`Contributors::`
			`- Oleg Kuznetsov, NVIDIA`
			`- Alex Dunn, NVIDIA`
			`- Jeff Bolz, NVIDIA`
			`- Eric Werness, NVIDIA`
			`- Daniel Koch, NVIDIA`


			`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 Object Types`

			`None.`

			`=== New Enum Constants`

			`Extending slink:VkStructureType:`

			`* ename:VK_STRUCTURE_TYPE_CHECKPOINT_DATA_NV`
			`* ename:VK_STRUCTURE_TYPE_QUEUE_FAMILY_CHECKPOINT_PROPERTIES_NV`

			`=== New Enums`

			`None.`

			`=== New Structures`

			`* slink:VkCheckpointDataNV`
			`* slink:VkQueueFamilyCheckpointPropertiesNV`

			`=== New Functions`

			`* flink:vkCmdSetCheckpointNV`
			`* flink:vkGetQueueCheckpointDataNV`

			`=== Issues`

			`None yet!`


			`=== Version History`

			`* Revision 1, 2018-07-16 (Nuno Subtil)`
			`- Internal revisions`