EN
此内容没有您的语言版本,但有英语版本。

D3DDisassemble11Trace function

Disassembles a section of compiled Microsoft High Level Shader Language (HLSL) code that is specified by shader trace steps.

Syntax

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

Parameters

pSrcData [in]

Type: LPCVOID

A pointer to compiled shader data.

SrcDataSize [in]

Type: SIZE_T

The size, in bytes, of the block of memory that pSrcData points to.

pTrace [in]

Type: ID3D11ShaderTrace*

A pointer to the ID3D11ShaderTrace interface for the shader trace information object.

StartStep [in]

Type: UINT

The number of the step in the trace from which D3DDisassemble11Trace starts the disassembly.

NumSteps [in]

Type: UINT

The number of trace steps to disassemble.

Flags [in]

Type: UINT

A combination of zero or more of the following flags that are combined by using a bitwise OR operation. The resulting value specifies how D3DDisassemble11Trace disassembles the compiled shader data.

FlagDescription
D3D_DISASM_ENABLE_COLOR_CODE (0x01)Enable the output of color codes.
D3D_DISASM_ENABLE_DEFAULT_VALUE_PRINTS (0x02)Enable the output of default values.
D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING (0x04)Enable instruction numbering.
D3D_DISASM_ENABLE_INSTRUCTION_CYCLE (0x08)No effect.
D3D_DISASM_DISABLE_DEBUG_INFO (0x10)Disable the output of debug information.
D3D_DISASM_ENABLE_INSTRUCTION_OFFSET (0x20)Enable the output of instruction offsets.
D3D_DISASM_INSTRUCTION_ONLY (0x40)

Enable the output of the instruction cycle per step in D3DDisassemble11Trace.

This flag is similar to the D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING and D3D_DISASM_ENABLE_INSTRUCTION_OFFSET flags.

This flag has no effect in the D3DDisassembleRegion function. Cycle information comes from the trace; therefore, cycle information is available only in the trace disassembly.

 

ppDisassembly [out]

Type: ID3DBlob**

A pointer to a buffer that receives the ID3DBlob interface that accesses the disassembled HLSL code.

Return value

Type: HRESULT

Returns one of the Direct3D 11 return codes.

Remarks

D3DDisassemble11Trace walks the steps of a shader trace and outputs appropriate disassembly for each step that is based on the step's instruction index. The disassembly is annotated with register-value information from the trace. The behavior of D3DDisassemble11Trace differs from D3DDisassemble in that instead of the static disassembly of a compiled shader that D3DDisassemble performs, D3DDisassemble11Trace provides an execution trace that is based on the shader trace information.

Note  The D3dcompiler_44.dll or later version of the file contains the D3DDisassemble11Trace compiler function.

Windows Phone 8.1: This API is supported.

Requirements

Header

D3D11ShaderTracing.h

Library

D3DCompiler.lib

DLL

D3DCompiler_47.dll

See also

Functions

 

 

社区附加资源

添加
显示:
© 2014 Microsoft