ID3D11ShaderTrace::GetWrittenRegister-Methode (d3d11shadertracing.h)

Ruft Informationen zu einem Register ab, das von einem Schritt in der Ablaufverfolgung geschrieben wurde.

Syntax

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

Parameter

[in] stepIndex

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

[in] writtenRegisterIndex

Der Index des Registers innerhalb des Ablaufverfolgungsschritts. Der Indexbereich ist [0...NumRegistersWritten-1], wobei NumRegistersWritten ein Element der D3D11_TRACE_STEP-Struktur ist.

[out] pRegister

Ein Zeiger auf eine D3D11_TRACE_REGISTER-Struktur . GetWrittenRegister füllt die Member dieser Struktur mit Informationen über das Register aus, das vom Schritt in der Ablaufverfolgung geschrieben wurde.

[out] pValue

Ein Zeiger auf eine D3D11_TRACE_VALUE-Struktur . GetWrittenRegister füllt die Member dieser Struktur mit Informationen über den Wert aus, der in das Register geschrieben wurde.

Rückgabewert

GetWrittenRegister gibt Folgendes zurück:

  • S_OK , wenn die -Methode die Registerinformationen abruft.
  • E_FAIL , wenn eine Ablaufverfolgung nicht verfügbar ist oder die Ablaufverfolgung nicht mit dem D3D11_SHADER_TRACE_FLAG_RECORD_REGISTER_WRITES-Flag erstellt wurde.
  • E_INVALIDARG , wenn stepIndex oder writtenRegisterIndex außerhalb des Bereichs liegt oder ob 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