ID3D11ShaderTrace ::GetInitialRegisterContents, méthode (d3d11shadertracing.h)

  • Article

Récupère le contenu initial du registre d’entrée spécifié.

Syntaxe

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

Paramètres

[in] pRegister

Pointeur vers une structure D3D11_TRACE_REGISTER qui décrit le registre d’entrée à partir duquel récupérer le contenu initial. Vous pouvez récupérer des données initiales valides à partir des types de registre d’entrée suivants. Autrement dit, pour récupérer des données valides, le membre RegType de D3D11_TRACE_REGISTER doit être l’une des valeurs suivantes :

  • D3D11_TRACE_INPUT_REGISTER
  • D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER
  • D3D11_TRACE_IMMEDIATE_CONSTANT_BUFFER
Les données valides sont indiquées par le membre ValidMask de la structure D3D11_TRACE_VALUE vers laquelle pValue pointe.

[out] pValue

Pointeur vers une structure D3D11_TRACE_VALUE . GetInitialRegisterContents remplit les membres de cette structure avec des informations sur le contenu initial.

Valeur retournée

GetInitialRegisterContents retourne :

  • S_OK si la méthode récupère le contenu du registre initial.
  • E_FAIL si aucune trace n’est disponible.
  • E_INVALIDARG si pRegister n’est pas valide ou null ou si pValue a la valeur NULL.
  • Peut-être d’autres codes d’erreur décrits dans Codes de retour Direct3D 11.

Remarques

Vous pouvez appeler GetInitialRegisterContents pour les registres autres que les types de registre d’entrée spécifiés dans la description du paramètre pRegister . Toutefois, GetInitialRegisterContents définit le membre ValidMask de la structure D3D11_TRACE_VALUE vers laquelle pValue pointe vers vide (tous les zéros, 0000), et les valeurs de registre que le membre Bits de D3D11_TRACE_VALUE spécifie sont sans signification. Les données retournées par GetInitialRegisterContents ne sont pas affectées par le pas à pas dans une trace ; Toutefois, les données retournées sont affectées par la modification de l’index d’empreinte par un appel à ID3D11ShaderTrace ::P SSelectStamp.

Note Cette API nécessite le Kit de développement logiciel (SDK) Windows pour Windows 8.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d3d11shadertracing.h
DLL D3D11SDKLayers.dll ; D3D11_1SDKLayers.dll ; D3D11_2SDKLayers.dll

Voir aussi

ID3D11ShaderTrace