D3DDisassemble11Trace, fonction (d3d11shadertracing.h)
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 |