ID3D11ShaderTrace::GetReadRegister method

Retrieves information about a register that was read by a step in the trace.

Syntax

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

Parameters

stepIndex [in]

The index of the step within the trace. The range of the index is [0...NumTraceSteps-1], where NumTraceSteps is a member of the D3D11_TRACE_STATS structure. You can retrieve information in any step order.

readRegisterIndex [in]

The index of the register within the trace step. The range of the index is [0...NumRegistersRead-1], where NumRegistersRead is a member of the D3D11_TRACE_STEP structure.

pRegister [out]

A pointer to a D3D11_TRACE_REGISTER structure. GetReadRegister fills the members of this structure with information about the register that was read by the step in the trace.

pValue [out]

A pointer to a D3D11_TRACE_VALUE structure. GetReadRegister fills the members of this structure with information about the value that was read from the register.

Return value

GetReadRegister returns:

• S_OK if the method retrieves the register information.
• E_FAIL if a trace is not available or if the trace was not created with the D3D11_SHADER_TRACE_FLAG_RECORD_REGISTER_READS flag.
• E_INVALIDARG if stepIndex or readRegisterIndex is out of range or if pRegister or pValue is NULL.
• Possibly other error codes that are described in Direct3D 11 Return Codes.

Remarks

This API requires the Windows Software Development Kit (SDK) for Windows 8.

Requirements

See also

ID3D11ShaderTrace

Send comments about this topic to Microsoft

Build date: 11/28/2012