ID3D11ShaderTrace::GetInitialRegisterContents-Methode (d3d11shadertracing.h)

  • Artikel

Ruft den ursprünglichen Inhalt des angegebenen Eingaberegisters ab.

Syntax

HRESULT GetInitialRegisterContents(
  [in]  D3D11_TRACE_REGISTER *pRegister,
  [out] D3D11_TRACE_VALUE    *pValue
);

Parameter

[in] pRegister

Ein Zeiger auf eine D3D11_TRACE_REGISTER-Struktur , die das Eingaberegister beschreibt, aus dem der anfängliche Inhalt abgerufen werden soll. Sie können gültige Anfangsdaten nur aus den folgenden Eingaberegistertypen abrufen. Das heißt, das RegType-Element von D3D11_TRACE_REGISTER muss einer der folgenden Werte sein, um gültige Daten abzurufen:

  • D3D11_TRACE_INPUT_REGISTER
  • D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER
  • D3D11_TRACE_IMMEDIATE_CONSTANT_BUFFER
Gültige Daten werden durch den ValidMask-Member der D3D11_TRACE_VALUE-Struktur angegeben, auf die pValue zeigt.

[out] pValue

Ein Zeiger auf eine D3D11_TRACE_VALUE-Struktur . GetInitialRegisterContents füllt die Member dieser Struktur mit Informationen über den ursprünglichen Inhalt.

Rückgabewert

GetInitialRegisterContents gibt Folgendes zurück:

  • S_OK , wenn die -Methode den anfänglichen Registerinhalt abruft.
  • E_FAIL , wenn keine Ablaufverfolgung verfügbar ist.
  • E_INVALIDARG , wenn pRegister ungültig oder NULL ist oder ob pValue NULL ist.
  • Möglicherweise andere Fehlercodes, die in Direct3D 11-Rückgabecodes beschrieben werden.

Hinweise

Sie können GetInitialRegisterContents für andere Register als die Eingaberegistertypen aufrufen, die in der pRegister-Parameterbeschreibung angegeben sind. GetInitialRegisterContents legt jedoch den ValidMask-Member der D3D11_TRACE_VALUE-Struktur fest, auf die pValue auf leer zeigt (alle Nullen, 0000), und die Registerwerte, die der Bits-Member von D3D11_TRACE_VALUE angibt, sind bedeutungslos. Die Daten, die GetInitialRegisterContents zurückgibt, sind durch das Schrittweisen in einer Ablaufverfolgung nicht betroffen. Die zurückgegebenen Daten werden jedoch durch das Ändern des Stempelindexes durch einen Aufruf von ID3D11ShaderTrace::P SSelectStamp beeinflusst.

Hinweis 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