D3DGetTraceInstructionOffsets function

Note  You can use this API to develop your Windows Store apps, but you can't use it in apps that you submit to the Windows Store.

Retrieves the byte offsets for instructions within a section of shader code.

Syntax

HRESULT WINAPI D3DGetTraceInstructionOffsets(
  in   LPCVOID pSrcData,
  in   SIZE_T SrcDataSize,
  in   UINT Flags,
  in   SIZE_T StartInstIndex,
  in   SIZE_T NumInsts,
  out  SIZE_T *pOffsets,
  out  SIZE_T *pTotalInsts
);

Parameters

pSrcData [in]

A pointer to the compiled shader data.

SrcDataSize [in]

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

Flags [in]

A combination of the following flags that are combined by using a bitwise OR operation. The resulting value specifies how D3DGetTraceInstructionOffsets retrieves the instruction offsets.

Flag	Description
D3D_GET_INST_OFFSETS_INCLUDE_NON_EXECUTABLE (0x01)	Include non-executable code in the retrieved information.

 

StartInstIndex [in]

The index of the instruction in the compiled shader data for which D3DGetTraceInstructionOffsets starts to retrieve the byte offsets.

NumInsts [in]

The number of instructions for which D3DGetTraceInstructionOffsets retrieves the byte offsets.

pOffsets [out]

A pointer to a variable that receives the actual number of offsets.

pTotalInsts [out]

A pointer to a variable that receives the total number of instructions in the section of shader code.

Remarks

A new kind of Microsoft High Level Shader Language (HLSL) debugging information from a program database (PDB) file uses instruction-byte offsets within a shader blob (arbitrary-length data buffer). You use D3DGetTraceInstructionOffsets to translate to and from instruction indexes.

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

Requirements

See also

Functions

Send comments about this topic to Microsoft

Build date: 3/5/2013