ID3D11ShaderTrace：：GetInitialRegisterContents 方法 (d3d11shadertracing.h)

  • 發行項

擷取指定之輸入緩存器的初始內容。

語法

HRESULT GetInitialRegisterContents(
  [in]  D3D11_TRACE_REGISTER *pRegister,
  [out] D3D11_TRACE_VALUE    *pValue
);

參數

[in] pRegister

描述要從中擷取初始內容的輸入緩存器 之D3D11_TRACE_REGISTER 結構的指標。 您只能從下列輸入緩存器類型擷取有效的初始數據。 也就是說，若要擷取有效數據，D3D11_TRACE_REGISTER的 RegType 成員必須是下列其中一個值：

  • D3D11_TRACE_INPUT_REGISTER
  • D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER
  • D3D11_TRACE_IMMEDIATE_CONSTANT_BUFFER
有效數據是由 pValue 指向之D3D11_TRACE_VALUE結構的 ValidMask 成員所表示。

[out] pValue

D3D11_TRACE_VALUE 結構的指標。 GetInitialRegisterContents 會將初始內容的相關信息填入此結構的成員。

傳回值

GetInitialRegisterContents 會傳回：

  • 如果 方法擷取初始緩存器內容，S_OK。
  • 如果追蹤無法使用，E_FAIL。
  • 如果pRegister 無效或 NULL 或 pValue 為 NULL，E_INVALIDARG。
  • 可能是 Direct3D 11 傳回碼中所述的其他錯誤碼。

備註

您可以呼叫 GetInitialRegisterContents ，以取得 pRegister 參數描述中指定的輸入緩存器類型以外的緩存器。 不過，GetInitialRegisterContents 會將 pValue 指向空 D3D11_TRACE_VALUE ( 所有零、0000) ，以及D3D11_TRACE_VALUE位指定之位成員指定的緩存器值設定為空的 ValidMask 成員。 GetInitialRegisterContents 傳回的數據不會受到追蹤中的逐步執行影響;不過，傳回的數據會透過呼叫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