ID3D11ShaderTrace：：TraceReady 方法 (d3d11shadertracing.h)

  • 發行項

指定已記錄且已準備好使用的著色器追蹤。

語法

HRESULT TraceReady(
  [out, optional] UINT64 *pTestCount
);

參數

[out, optional] pTestCount

變數的選擇性指標，可接收發生追蹤相符調用的次數。 如果未使用，請將 設定為 NULL。 如需此數字的詳細資訊，請參閱。

傳回值

TraceReady 會傳回：

  • 如果 追蹤已就緒，S_OK。
  • 如果 追蹤尚未就緒，S_FALSE。
  • 如果 追蹤在錄製過程中記憶體用盡，E_OUTOFMEMORY。 您可以呼叫 ID3D11ShaderTrace：：ResetTrace ，然後重新繪製，嘗試再次記錄追蹤。 如果您決定不要再次記錄追蹤，請釋放 ID3D11ShaderTrace 介面。
  • 可能是 Direct3D 11 傳回碼中所述的其他錯誤碼。

備註

如果追蹤是要記錄呼叫 3，但到目前為止只有兩個呼叫發生， TraceReady 會將 pTestCount 指向 2 的變數設定為 。 您可以使用此值來了解追蹤尚未就緒的原因。 相反地， pTestCount 點的變數可能大於已就緒之追蹤所要求的調用計數。 您可以使用此值來判斷超過所需追蹤調用計數的調用數目。 例如，您可能不知道繪製呼叫中指定著色器在像素上發生的過度繪製數目。 如果可以相同地重新繪製場景，您可以根據第一次通過時在 pTestCount 傳回的 TraceReady 值，設定下一次追蹤。

如果記錄著色器追蹤，您可以成功呼叫 ID3D11ShaderTrace：：GetTraceStats、 ID3D11ShaderTrace：：GetInitialRegisterContents 和 ID3D11ShaderTrace：：GetStep 方法。 不論是否已記錄著色器追蹤，您都可以呼叫 ID3D11ShaderTrace：：ResetTrace 和 ID3D11ShaderTrace：:P SSelectStamp 方法。

注意此 API 需要適用於 Windows 8 的 Windows 軟體開發工具包 (SDK) 。
 

規格需求

需求 值
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d3d11shadertracing.h
Dll D3D11SDKLayers.dll;D3D11_1SDKLayers.dll;D3D11_2SDKLayers.dll

另請參閱

ID3D11ShaderTrace