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 返回代码中描述的其他错误代码。

注解

可以为 pRegister 参数说明中指定的输入寄存器类型以外的寄存器调用 GetInitialRegisterContents。 但是，GetInitialRegisterContents 将 pValue 指向的 D3D11_TRACE_VALUE 结构的 ValidMask 成员设置为空， (所有零、0000) ，并且 D3D11_TRACE_VALUE 的 Bits 成员指定的寄存器值毫无意义。 GetInitialRegisterContents 返回的数据不受跟踪单步执行的影响;但是，通过调用 ID3D11ShaderTrace：:P SSelectStamp 更改标记索引会影响返回的数据。

注意此 API 需要 Windows 软件开发工具包 (SDK) Windows 8。
 

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d3d11shadertracing.h
DLL D3D11SDKLayers.dll;D3D11_1SDKLayers.dll;D3D11_2SDKLayers.dll

另请参阅

ID3D11ShaderTrace