Funzione D3DDisassemble11Trace (d3d11shadertracing.h)

  • Articolo

Disassembla una sezione del codice Microsoft High Level Shader Language (HLSL) compilato specificato dai passaggi di traccia shader.

Sintassi

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

Parametri

[in] pSrcData

Tipo: LPCVOID

Puntatore ai dati dello shader compilati.

[in] SrcDataSize

Tipo: SIZE_T

Dimensioni, in byte, del blocco di memoria a cui pSrcData punta.

[in] pTrace

Tipo: ID3D11ShaderTrace*

Puntatore all'interfaccia ID3D11ShaderTrace per l'oggetto informazioni di traccia shader.

[in] StartStep

Tipo: UINT

Numero del passaggio nella traccia da cui D3DDisassemble11Trace avvia il disassembly.

[in] NumSteps

Tipo: UINT

Numero di passaggi di traccia da smontare.

[in] Flags

Tipo: UINT

Combinazione di zero o più flag seguenti combinati usando un'operazione OR bit per bit. Il valore risultante specifica come D3DDisassemble11Trace smonta i dati dello shader compilati.

Flag Descrizione
D3D_DISASM_ENABLE_COLOR_CODE (0x01) Abilitare l'output dei codici di colore.
D3D_DISASM_ENABLE_DEFAULT_VALUE_PRINTS (0x02) Abilitare l'output dei valori predefiniti.
D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING (0x04) Abilitare il numero di istruzioni.
D3D_DISASM_ENABLE_INSTRUCTION_CYCLE (0x08) Nessun effetto.
D3D_DISASM_DISABLE_DEBUG_INFO (0x10) Disabilitare l'output delle informazioni di debug.
D3D_DISASM_ENABLE_INSTRUCTION_OFFSET (0x20) Abilitare l'output degli offset delle istruzioni.
D3D_DISASM_INSTRUCTION_ONLY (0x40) Abilitare l'output del ciclo di istruzioni per passaggio in D3DDisassemble11Trace. Questo flag è simile ai flag di D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING e D3D_DISASM_ENABLE_INSTRUCTION_OFFSET.

Questo flag non ha alcun effetto nella funzione D3DDisassembleRegion. Le informazioni sul ciclo provengono dalla traccia; pertanto, le informazioni sul ciclo sono disponibili solo nel disassembly di traccia.

[out] ppDisassembly

Tipo: ID3D10Blob**

Puntatore a un buffer che riceve l'interfaccia ID3DBlob che accede al codice HLSL disassemblato.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce un codice di errore HRESULT.

Commenti

D3DDisassemble11Trace illustra i passaggi di una traccia shader e restituisce il disassembly appropriato per ogni passaggio basato sull'indice delle istruzioni del passaggio. Il disassembly viene annotato con informazioni sul valore del registro dalla traccia. Il comportamento di D3DDisassemble11Trace differisce da D3DDisassemble in che invece del disassembling statico di un shader compilato che D3DDisassemble esegue, D3DDisassemble11Trace fornisce una traccia di esecuzione basata sulle informazioni sulla traccia dello shader.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione d3d11shadertracing.h
DLL D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll

Vedi anche

Funzioni shader