ID3D11ShaderTrace：：GetReadRegister 方法 (d3d11shadertracing.h)

  • 發行項

擷取追蹤中步驟所讀取之緩存器的相關信息。

語法

HRESULT GetReadRegister(
  [in]  UINT                 stepIndex,
  [in]  UINT                 readRegisterIndex,
  [out] D3D11_TRACE_REGISTER *pRegister,
  [out] D3D11_TRACE_VALUE    *pValue
);

參數

[in] stepIndex

追蹤中步驟的索引。 索引的範圍是 [0...NumTraceSteps-1]，其中 NumTraceSteps 是 D3D11_TRACE_STATS 結構的成員。 您可以依任何步驟順序擷取資訊。

[in] readRegisterIndex

追蹤步驟內的緩存器索引。 索引的範圍是 [0...NumRegistersRead-1]，其中 NumRegistersRead 是 D3D11_TRACE_STEP 結構的成員。

[out] pRegister

D3D11_TRACE_REGISTER 結構的指標。 GetReadRegister 會填入此結構的成員，其中包含追蹤中步驟所讀取之緩存器的相關信息。

[out] pValue

D3D11_TRACE_VALUE 結構的指標。 GetReadRegister 會填入這個結構的成員，其中包含從緩存器讀取的值相關信息。

傳回值

GetReadRegister 會傳回：

  • 如果 方法擷取緩存器資訊，S_OK。
  • E_FAIL 如果無法使用追蹤，或是未使用 D3D11_SHADER_TRACE_FLAG_RECORD_REGISTER_READS 旗標建立追蹤。
  • E_INVALIDARG 如果 stepIndex 或 readRegisterIndex 超出範圍，或 pRegister 或 pValue 為 NULL。
  • Direct3D 11 傳回碼中可能描述的其他錯誤碼。

備註

此 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