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
[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 |