Función D3DDisassemble11Trace (d3d11shadertracing.h)
Desensambla una sección del código compilado de Microsoft High Level Shader Language (HLSL) especificado por los pasos de seguimiento del sombreador.
Sintaxis
HRESULT D3DDisassemble11Trace(
[in] LPCVOID pSrcData,
[in] SIZE_T SrcDataSize,
[in] ID3D11ShaderTrace *pTrace,
[in] UINT StartStep,
[in] UINT NumSteps,
[in] UINT Flags,
[out] ID3D10Blob **ppDisassembly
);
Parámetros
[in] pSrcData
Tipo: LPCVOID
Puntero a los datos del sombreador compilados.
[in] SrcDataSize
Tipo: SIZE_T
Tamaño, en bytes, del bloque de memoria al que apunta pSrcData.
[in] pTrace
Tipo: ID3D11ShaderTrace*
Puntero a la interfaz ID3D11ShaderTrace para el objeto de información de seguimiento del sombreador.
[in] StartStep
Tipo: UINT
Número del paso del seguimiento desde el que D3DDisassemble11Trace inicia el desensamblaje.
[in] NumSteps
Tipo: UINT
Número de pasos de seguimiento que se van a desensamblar.
[in] Flags
Tipo: UINT
Combinación de cero o más de las marcas siguientes que se combinan mediante una operación OR bit a bit. El valor resultante especifica cómo D3DDisassemble11Trace desensambla los datos del sombreador compilado.
| Marca | Descripción |
|---|---|
| D3D_DISASM_ENABLE_COLOR_CODE (0x01) | Habilite la salida de los códigos de color. |
| D3D_DISASM_ENABLE_DEFAULT_VALUE_PRINTS (0x02) | Habilite la salida de los valores predeterminados. |
| D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING (0x04) | Habilite la numeración de instrucciones. |
| D3D_DISASM_ENABLE_INSTRUCTION_CYCLE (0x08) | Ningún efecto. |
| D3D_DISASM_DISABLE_DEBUG_INFO (0x10) | Deshabilite la salida de la información de depuración. |
| D3D_DISASM_ENABLE_INSTRUCTION_OFFSET (0x20) | Habilite la salida de desplazamientos de instrucciones. |
| D3D_DISASM_INSTRUCTION_ONLY (0x40) |
Habilite la salida del ciclo de instrucciones por paso en D3DDisassemble11Trace. Esta marca es similar a las marcas D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING y D3D_DISASM_ENABLE_INSTRUCTION_OFFSET.
Esta marca no tiene ningún efecto en la función D3DDisassembleRegion. La información del ciclo proviene del seguimiento; por lo tanto, la información del ciclo solo está disponible en el desensamblaje de seguimiento. |
[out] ppDisassembly
Tipo: ID3D10Blob**
Puntero a un búfer que recibe la interfaz ID3DBlob que accede al código HLSL desmontado.
Valor devuelto
Tipo: HRESULT
Este método devuelve un código de error HRESULT.
Comentarios
D3DDisassemble11Trace recorre los pasos de un seguimiento del sombreador y genera el desensamblaje adecuado para cada paso que se basa en el índice de instrucciones del paso. El desensamblado se anota con información de valor de registro del seguimiento. El comportamiento de D3DDisassemble11Trace difiere de D3DDisassemble en que, en lugar del desensamblaje estático de un sombreador compilado que realiza D3DDisassemble, D3DDisassemble11Trace proporciona un seguimiento de ejecución basado en la información de seguimiento del sombreador.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | d3d11shadertracing.h |
| Archivo DLL | D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll |