D3D11_TRACE_STEP structure (d3d11shadertracing.h)
Describes a trace step, which is an instruction.
Syntax
typedef struct D3D11_TRACE_STEP {
UINT ID;
BOOL InstructionActive;
UINT8 NumRegistersWritten;
UINT8 NumRegistersRead;
D3D11_TRACE_MISC_OPERATIONS_MASK MiscOperations;
UINT OpcodeType;
UINT64 CurrentGlobalCycle;
} D3D11_TRACE_STEP;
Members
ID
A number that identifies the instruction, as an offset into the executable instructions that are present in the shader.
HLSL debugging information uses the same convention. Therefore, HLSL instructions are matched to a set of IDs. You can then map an ID to a disassembled string that can be displayed to the user.
InstructionActive
A value that specifies whether the instruction is active. This value is TRUE if something happened; therefore, you should parse other data in this structure. Otherwise, nothing happened; for example, if an instruction is disabled due to flow control even though other pixels in the stamp execute it.
NumRegistersWritten
The number of registers for the instruction that are written to. The range of registers is [0...NumRegistersWritten-1]. You can pass a register number to the writtenRegisterIndex parameter of ID3D11ShaderTrace::GetWrittenRegister to retrieve individual write-register information.
NumRegistersRead
The number of registers for the instruction that are read from. The range of registers is [0...NumRegistersRead-1]. You can pass a register number to the readRegisterIndex parameter of ID3D11ShaderTrace::GetReadRegister to retrieve individual read-register information.
MiscOperations
A combination of the following values that are combined by using a bitwise OR operation. The resulting value specifies the mask for the trace miscellaneous operations. These flags indicate the possible effect of a shader operation when it does not write any output registers. For example, the "add r0, r1 ,r2" operation writes to the r0 register; therefore, you can look at the trace-written register's information to determine what the operation changed. However, some shader instructions do not write any registers, but still effect those registers.
| Flag | Description |
|---|---|
| D3D11_TRACE_MISC_GS_EMIT (0x1) | The operation was a geometry shader data emit. |
| D3D11_TRACE_MISC_GS_CUT (0x2) | The operation was a geometry shader strip cut. |
| D3D11_TRACE_MISC_PS_DISCARD (0x4) | The operation was a pixel shader discard, which rejects the pixel. |
| D3D11_TRACE_MISC_GS_EMIT_STREAM (0x8) | Same as D3D11_TRACE_MISC_GS_EMIT, except in shader model 5 where you can specify a particular stream to emit to. |
| D3D11_TRACE_MISC_GS_CUT_STREAM (0x10) | Same as D3D11_TRACE_MISC_GS_CUT, except in shader model 5 where you can specify a particular stream to strip cut. |
| D3D11_TRACE_MISC_HALT (0x20) | The operation was a shader halt instruction, which stops shader execution. The HLSL abort intrinsic function causes a halt. |
| D3D11_TRACE_MISC_MESSAGE (0x40) | The operation was a shader message output, which can be logged to the information queue. The HLSL printf and errorf intrinsic functions cause messages. |
If the NumRegistersWritten member is 0, examine this member although this member still might be empty (0).
OpcodeType
A number that specifies the type of instruction (for example, add, mul, and so on). You can ignore this member if you do not know the number for the instruction type. This member offers a minor convenience at the cost of bloating the trace slightly. You can use the ID member and map back to the original shader code to retrieve the full information about the instruction.
CurrentGlobalCycle
The global cycle count for this step. You can use this member to correlate parallel thread execution via multiple simultaneous traces, for example, for the compute shader.
Remarks
This API requires the Windows Software Development Kit (SDK) for Windows 8.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Header | d3d11shadertracing.h |