ID3D11ShaderTrace::GetReadRegister-Methode (d3d11shadertracing.h)

  • Artikel

Ruft Informationen zu einem Register ab, das durch einen Schritt in der Ablaufverfolgung gelesen wurde.

Syntax

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

Parameter

[in] stepIndex

Der Index des Schritts innerhalb der Ablaufverfolgung. Der Bereich des Indexes ist [0...NumTraceSteps-1], wobei NumTraceSteps ein Element der D3D11_TRACE_STATS-Struktur ist. Sie können Informationen in beliebiger Schrittreihenfolge abrufen.

[in] readRegisterIndex

Der Index des Registers innerhalb des Ablaufverfolgungsschritts. Der Bereich des Indexes ist [0...NumRegistersRead-1], wobei NumRegistersRead ein Mitglied der D3D11_TRACE_STEP-Struktur ist.

[out] pRegister

Ein Zeiger auf eine D3D11_TRACE_REGISTER Struktur. GetReadRegister füllt die Elemente dieser Struktur mit Informationen über das Register, das vom Schritt in der Ablaufverfolgung gelesen wurde.

[out] pValue

Ein Zeiger auf eine D3D11_TRACE_VALUE-Struktur . GetReadRegister füllt die Member dieser Struktur mit Informationen über den Wert, der aus dem Register gelesen wurde.

Rückgabewert

GetReadRegister gibt Folgendes zurück:

  • S_OK , wenn die -Methode die Registerinformationen abruft.
  • E_FAIL , wenn keine Ablaufverfolgung verfügbar ist oder wenn die Ablaufverfolgung nicht mit dem D3D11_SHADER_TRACE_FLAG_RECORD_REGISTER_READS-Flag erstellt wurde.
  • E_INVALIDARG , wenn sich stepIndex oder readRegisterIndex außerhalb des Bereichs befindet oder pRegister oder pValue NULL ist.
  • Möglicherweise andere Fehlercodes, die in Direct3D 11-Rückgabecodes beschrieben werden.

Hinweise

Für diese API ist das Windows Software Development Kit (SDK) für Windows 8 erforderlich.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d3d11shadertracing.h
DLL D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll

Weitere Informationen

ID3D11ShaderTrace