Função D3DDisassemble11Trace (d3d11shadertracing.h)
Desmonta uma seção do código HLSL (Microsoft High Level Shader Language) compilado especificado pelas etapas de rastreamento do sombreador.
Sintaxe
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
Um ponteiro para dados de sombreador compilados.
[in] SrcDataSize
Tipo: SIZE_T
O tamanho, em bytes, do bloco de memória para o qual pSrcData aponta.
[in] pTrace
Tipo: ID3D11ShaderTrace*
Um ponteiro para a interface ID3D11ShaderTrace para o objeto de informações de rastreamento do sombreador.
[in] StartStep
Tipo: UINT
O número da etapa no rastreamento do qual D3DDisassemble11Trace inicia a desmontagem.
[in] NumSteps
Tipo: UINT
O número de etapas de rastreamento a serem desmontadas.
[in] Flags
Tipo: UINT
Uma combinação de zero ou mais dos sinalizadores a seguir que são combinados usando uma operação OR bit a bit. O valor resultante especifica como D3DDisassemble11Trace desmonta os dados do sombreador compilado.
| Sinalizador | Descrição |
|---|---|
| D3D_DISASM_ENABLE_COLOR_CODE (0x01) | Habilite a saída de códigos de cor. |
| D3D_DISASM_ENABLE_DEFAULT_VALUE_PRINTS (0x02) | Habilite a saída de valores padrão. |
| D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING (0x04) | Habilitar a numeração de instruções. |
| D3D_DISASM_ENABLE_INSTRUCTION_CYCLE (0x08) | Nenhum efeito. |
| D3D_DISASM_DISABLE_DEBUG_INFO (0x10) | Desabilite a saída das informações de depuração. |
| D3D_DISASM_ENABLE_INSTRUCTION_OFFSET (0x20) | Habilite a saída de deslocamentos de instrução. |
| D3D_DISASM_INSTRUCTION_ONLY (0x40) |
Habilite a saída do ciclo de instrução por etapa em D3DDisassemble11Trace. Esse sinalizador é semelhante aos sinalizadores D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING e D3D_DISASM_ENABLE_INSTRUCTION_OFFSET.
Esse sinalizador não tem efeito na função D3DDisassembleRegion. As informações de ciclo vêm do rastreamento; portanto, as informações de ciclo estão disponíveis apenas na desmontagem de rastreamento. |
[out] ppDisassembly
Tipo: ID3D10Blob**
Um ponteiro para um buffer que recebe a interface ID3DBlob que acessa o código HLSL desmontado.
Retornar valor
Tipo: HRESULT
Esse método retorna um código de erro HRESULT.
Comentários
D3DDisassemble11Trace percorre as etapas de um rastreamento de sombreador e gera a desmontagem apropriada para cada etapa baseada no índice de instrução da etapa. A desmontagem é anotada com informações de valor de registro do rastreamento. O comportamento de D3DDisassemble11Trace difere de D3DDisassemble em que, em vez da desmontagem estática de um sombreador compilado executado por D3DDisassemble, D3DDisassemble11Trace fornece um rastreamento de execução baseado nas informações de rastreamento do sombreador.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | d3d11shadertracing.h |
| DLL | D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll |