Edit

ID3D11ShaderTrace interface (d3d11shadertracing.h)

  • Article

An ID3D11ShaderTrace interface implements methods for obtaining traces of shader executions.

Inheritance

The ID3D11ShaderTrace interface inherits from the IUnknown interface. ID3D11ShaderTrace also has these types of members:

Methods

The ID3D11ShaderTrace interface has these methods.

 
ID3D11ShaderTrace::GetInitialRegisterContents

Retrieves the initial contents of the specified input register.
ID3D11ShaderTrace::GetReadRegister

Retrieves information about a register that was read by a step in the trace.
ID3D11ShaderTrace::GetStep

Retrieves information about the specified step in the trace.
ID3D11ShaderTrace::GetTraceStats

Returns statistics about the trace.
ID3D11ShaderTrace::GetWrittenRegister

Retrieves information about a register that was written by a step in the trace.
ID3D11ShaderTrace::PSSelectStamp

Sets the specified pixel-shader stamp.
ID3D11ShaderTrace::ResetTrace

Resets the shader-trace object.
ID3D11ShaderTrace::TraceReady

Specifies that the shader trace recorded and is ready to use.

Remarks

To retrieve an instance of ID3D11ShaderTrace, call the ID3D11ShaderTraceFactory::CreateShaderTrace method. To retrieve an instance of ID3D11ShaderTraceFactory, call IUnknown::QueryInterface on a ID3D11Device that you created with D3D11_CREATE_DEVICE_DEBUGGABLE. Although shader tracing operates without setting D3D11_CREATE_DEVICE_DEBUGGABLE, we recommend that you create a shader debugging device because some devices (for example, WARP devices) might make behind-the-scenes shader optimizations that will lead to slightly incorrect shader traces when D3D11_CREATE_DEVICE_DEBUGGABLE isn't set.

All ID3D11ShaderTrace methods are thread safe.

All ID3D11ShaderTrace methods immediately force the reference device to flush rendering commands. Therefore, the most current trace status is always available on the reference device. That is, if you expect a trace to be ready after a draw operation, it will be ready.

Note  This API requires the Windows Software Development Kit (SDK) for Windows 8.
 

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header d3d11shadertracing.h

See also

IUnknown

Shader Interfaces