ID3D11ShaderTrace interface

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

Members

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

Methods

The ID3D11ShaderTrace interface has these methods.

MethodDescription
GetInitialRegisterContents

Retrieves the initial contents of the specified input register.

GetReadRegister

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

GetStep

Retrieves information about the specified step in the trace.

GetTraceStats

Returns statistics about the trace.

GetWrittenRegister

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

PSSelectStamp

Sets the specified pixel-shader stamp.

ResetTrace

Resets the shader-trace object.

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

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

D3D11ShaderTracing.h

DLL

D3D11SDKLayers.dll;
D3D11_1SDKLayers.dll;
D3D11_2SDKLayers.dll

See also

Shader Interfaces

 

 

Community Additions

ADD
Show:
© 2014 Microsoft