Share via

D3D11_TRACE_STEP 結構 (d3d11shadertracing.h)

  • 發行項

描述追蹤步驟，這是指令。

語法

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;

成員

ID

識別指令的數位，做為著色器中存在之可執行指令的位移。

HLSL 偵錯資訊使用相同的慣例。 因此，HLSL 指令會與一組識別碼相符。 然後，您可以將識別碼對應至可向使用者顯示的反組譯字串。

InstructionActive

值，指定指令是否作用中。 如果發生問題，此值為 TRUE;因此，您應該剖析此結構中的其他資料。 否則，不會發生任何事;例如，如果指令因為流程式控制制而停用，即使戳記中的其他圖元執行它也一樣。

NumRegistersWritten

寫入指令的暫存器數目。 暫存器的範圍是 [0...NumRegistersWritten-1]。 您可以將暫存器號碼傳遞至ID3D11ShaderTrace：：GetWrittenRegister的writenRegisterIndex參數，以擷取個別的寫入暫存器資訊。

NumRegistersRead

讀取來源指令的暫存器數目。 暫存器的範圍是 [0...NumRegistersRead-1]。 您可以將暫存器號碼傳遞至ID3D11ShaderTrace：：GetReadRegister的readRegisterIndex參數，以擷取個別的讀取註冊資訊。

MiscOperations

使用位 OR 運算結合的下列值組合。 產生的值會指定追蹤其他作業的遮罩。 當著色器作業未寫入任何輸出暫存器時，這些旗標表示著色器作業的可能效果。 例如，「add r0， r1 ，r2」 作業會寫入 r0 暫存器;因此，您可以查看追蹤寫入暫存器的資訊，以判斷作業變更的內容。 不過，某些著色器指令不會寫入任何暫存器，但仍會影響這些暫存器。

旗標 描述
D3D11_TRACE_MISC_GS_EMIT (0x1) 作業是幾何著色器資料發出。
D3D11_TRACE_MISC_GS_CUT (0x2) 作業是幾何著色器帶形剪下。
D3D11_TRACE_MISC_PS_DISCARD (0x4) 作業是圖元著色器捨棄，會拒絕圖元。
D3D11_TRACE_MISC_GS_EMIT_STREAM (0x8) 與D3D11_TRACE_MISC_GS_EMIT相同，但 著色器模型 5 除外，您可以在其中指定要發出的特定資料流程。
D3D11_TRACE_MISC_GS_CUT_STREAM (0x10) 與D3D11_TRACE_MISC_GS_CUT相同，但 著色器模型 5 除外，您可以在其中指定要切割的特定資料流程。
D3D11_TRACE_MISC_HALT (0x20) 作業是著色器停止指令，可停止著色器執行。 HLSL 中止 內建函式會導致停止。
D3D11_TRACE_MISC_MESSAGE (0x40) 作業是著色器訊息輸出，可記錄到資訊佇列。 HLSL printf 和 errorf 內建函式會造成訊息。
 

如果 NumRegistersWritten 成員為 0，請檢查此成員，雖然此成員仍然可能是空的 (0) 。

OpcodeType

指定指令類型的數位 (例如 ，新增、 mul等) 。 如果您不知道指令類型的數位，可以忽略此成員。 此成員會提供一些便利性，但代價是略過追蹤。 您可以使用 識別碼 成員，並對應回原始著色器程式碼，以擷取指示的完整資訊。

CurrentGlobalCycle

此步驟的全域週期計數。 您可以使用這個成員，透過多個同時追蹤相互關聯平行線程執行，例如計算著色器。

注意 執行中相同時間點的多個執行緒可能會記錄相同的 CurrentGlobalCycle。
 

備註

此 API 需要適用于 Windows 8 的 Windows 軟體發展工具組 (SDK) 。

需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
標頭 d3d11shadertracing.h

另請參閱

著色器結構