Compartilhar via


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

Confira também

Funções de sombreador