Record and Replay Graph Extension

API

• Functions

  • zeGraphCreateExt

  • zeCommandListBeginGraphCaptureExt

  • zeCommandListBeginCaptureIntoGraphExt

  • zeCommandListIsGraphCaptureEnabledExt

  • zeCommandListEndGraphCaptureExt

  • zeCommandListGetGraphExt

  • zeGraphGetPrimaryCommandListExt

  • zeGraphSetDestructionCallbackExt

  • zeGraphInstantiateExt

  • zeCommandListAppendGraphExt

  • zeExecutableGraphGetSourceGraphExt

  • zeGraphIsEmptyExt

  • zeGraphDumpContentsExt

  • zeExecutableGraphDestroyExt

  • zeGraphDestroyExt

• Enumerations

  • ze_record_replay_graph_ext_version_t

  • ze_record_replay_graph_ext_flags_t

  • ze_record_replay_graph_ext_dump_mode_t

• Structures

  • ze_record_replay_graph_ext_properties_t

  • ze_record_replay_graph_ext_dump_desc_t

Record and Replay Graph

This extension allows applications to capture append operations from immediate command lists into a graph, instantiate that graph, and replay it efficiently.

Applications can query support and capabilities using ze_record_replay_graph_ext_properties_t and ze_record_replay_graph_ext_flags_t. Captured graphs can be inspected with zeGraphDumpContentsExt, and ze_record_replay_graph_ext_dump_desc_t controls dump behavior.

Typical Flow

1. Create a graph with zeGraphCreateExt, or begin capture directly on an immediate command list with zeCommandListBeginGraphCaptureExt.

2. Record append operations and optionally query capture state via zeCommandListIsGraphCaptureEnabledExt and zeCommandListGetGraphExt.

3. End capture using zeCommandListEndGraphCaptureExt.

4. Instantiate an executable graph with zeGraphInstantiateExt.

5. Submit the executable graph using zeCommandListAppendGraphExt.

6. Optionally dump graph contents with zeGraphDumpContentsExt.

7. Destroy executable and recorded graph objects using zeExecutableGraphDestroyExt and zeGraphDestroyExt.