Partager via

D3DDisassemble11Trace, fonction (d3d11shadertracing.h)

  • Article

Désassemble une section du code HLSL (Microsoft High Level Shader Language) compilé qui est spécifié par les étapes de suivi du nuanceur.

Syntaxe

HRESULT D3DDisassemble11Trace(
  [in]  LPCVOID           pSrcData,
  [in]  SIZE_T            SrcDataSize,
  [in]  ID3D11ShaderTrace *pTrace,
  [in]  UINT              StartStep,
  [in]  UINT              NumSteps,
  [in]  UINT              Flags,
  [out] ID3D10Blob        **ppDisassembly
);

Paramètres

[in] pSrcData

Type : LPCVOID

Pointeur vers les données de nuanceur compilées.

[in] SrcDataSize

Type : SIZE_T

Taille, en octets, du bloc de mémoire vers lequel pSrcData pointe.

[in] pTrace

Type : ID3D11ShaderTrace*

Pointeur vers l’interface ID3D11ShaderTrace pour l’objet d’informations de trace du nuanceur.

[in] StartStep

Type : UINT

Numéro de l’étape de la trace à partir de laquelle D3DDisassemble11Trace démarre le désassemblement.

[in] NumSteps

Type : UINT

Nombre d’étapes de trace à désassembler.

[in] Flags

Type : UINT

Combinaison de zéro ou plusieurs des indicateurs suivants qui sont combinés à l’aide d’une opération OR au niveau du bit. La valeur résultante spécifie la façon dont D3DDisassemble11Trace désassemble les données du nuanceur compilées.

Indicateur Description
D3D_DISASM_ENABLE_COLOR_CODE (0x01) Activez la sortie des codes de couleur.
D3D_DISASM_ENABLE_DEFAULT_VALUE_PRINTS (0x02) Activez la sortie des valeurs par défaut.
D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING (0x04) Activez la numérotation des instructions.
D3D_DISASM_ENABLE_INSTRUCTION_CYCLE (0x08) Aucun effet.
D3D_DISASM_DISABLE_DEBUG_INFO (0x10) Désactivez la sortie des informations de débogage.
D3D_DISASM_ENABLE_INSTRUCTION_OFFSET (0x20) Activez la sortie des décalages d’instruction.
D3D_DISASM_INSTRUCTION_ONLY (0x40) Activez la sortie du cycle d’instructions par étape dans D3DDisassemble11Trace. Cet indicateur est similaire aux indicateurs D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING et D3D_DISASM_ENABLE_INSTRUCTION_OFFSET.

Cet indicateur n’a aucun effet dans la fonction D3DDisassembleRegion. Les informations de cycle proviennent de la trace ; par conséquent, les informations de cycle sont disponibles uniquement dans le désassemblement de trace.

[out] ppDisassembly

Type : ID3D10Blob**

Pointeur vers une mémoire tampon qui reçoit l’interface ID3DBlob qui accède au code HLSL désassemblé.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code d’erreur HRESULT.

Remarques

D3DDisassemble11Trace suit les étapes d’une trace de nuanceur et génère le désassemblement approprié pour chaque étape basée sur l’index d’instructions de l’étape. Le désassemblement est annoté avec les informations de valeur de registre de la trace. Le comportement de D3DDisassemble11Trace diffère de D3DDisassemble en ce que, au lieu du désassemblement statique d’un nuanceur compilé effectué par D3DDisassemble11Trace, D3DDisassemble11Trace fournit une trace d’exécution basée sur les informations de trace du nuanceur.

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

Fonctions de nuanceur