Skip to content

Latest commit

 

History

History
95 lines (63 loc) · 3.82 KB

icorprofilerinfo-setilinstrumentedcodemap-method.md

File metadata and controls

95 lines (63 loc) · 3.82 KB
Raw
description title ms.date api_name api_location api_type f1_keywords helpviewer_keywords ms.assetid topic_type
Learn more about: ICorProfilerInfo::SetILInstrumentedCodeMap Method
ICorProfilerInfo::SetILInstrumentedCodeMap Method
03/30/2017
ICorProfilerInfo.SetILInstrumentedCodeMap
mscorwks.dll
COM
ICorProfilerInfo::SetILInstrumentedCodeMap
ICorProfilerInfo::SetILInstrumentedCodeMap method [.NET Framework profiling]
SetILInstrumentedCodeMap method [.NET Framework profiling]
bce1dcf8-b4ec-4e73-a917-f2df1ad49c8a
apiref

ICorProfilerInfo::SetILInstrumentedCodeMap Method

Sets a code map for the specified function using the specified common intermediate language (CIL) map entries.

Note

In .NET Framework version 2.0, calling SetILInstrumentedCodeMap on a FunctionID that represents a generic function in a particular application domain will affect all instances of that function in the application domain.

Syntax

HRESULT SetILInstrumentedCodeMap(
    [in]  FunctionID functionId,
    [in]  BOOL       fStartJit,
    [in]  ULONG      cILMapEntries,
    [in, size_is(cILMapEntries)] COR_IL_MAP rgILMapEntries[]);

Parameters

functionId
[in] The ID of the function for which to set the code map.

fStartJit
[in] A Boolean value that indicates whether the call to the SetILInstrumentedCodeMap method is the first for a particular FunctionID. Set fStartJit to true in the first call to SetILInstrumentedCodeMap for a given FunctionID, and to false thereafter.

cILMapEntries
[in] The number of elements in the cILMapEntries array.

rgILMapEntries
[in] An array of COR_IL_MAP structures, each of which specifies a CIL offset.

Remarks

A profiler often inserts statements within the source code of a method in order to instrument that method (for example, to notify when a given source line is reached). SetILInstrumentedCodeMap enables a profiler to map the original CIL instructions to their new locations. A profiler can use the ICorProfilerInfo::GetILToNativeMapping method to get the original CIL offset for a given native offset.

The debugger will assume that each old offset refers to a CIL offset within the original, unmodified CIL code, and that each new offset refers to the CIL offset within the new, instrumented code. The map should be sorted in increasing order. For stepping to work properly, follow these guidelines:

  • Do not reorder instrumented CIL code.

  • Do not remove the original CIL code.

  • Include entries for all the sequence points from the program database (PDB) file in the map. The map does not interpolate missing entries. So, given the following map:

    (0 old, 0 new)

    (5 old, 10 new)

    (9 old, 20 new)

    • An old offset of 0, 1, 2, 3, or 4 will be mapped to new offset 0.

    • An old offset of 5, 6, 7, or 8 will be mapped to new offset 10.

    • An old offset of 9 or higher will be mapped to new offset 20.

    • A new offset of 0, 1, 2, 3, 4, 5, 6, 7, 8, or 9 will be mapped to old offset 0.

    • A new offset of 10, 11, 12, 13, 14, 15, 16, 17, 18, or 19 will be mapped to old offset 5.

    • A new offset of 20 or higher will be mapped to old offset 9.

In the .NET Framework 3.5 and previous versions, you allocate the rgILMapEntries array by calling the CoTaskMemAlloc method. Because the runtime takes ownership of this memory, the profiler should not attempt to free it.

Requirements

Platforms: See System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: [!INCLUDEnet_current_v11plus]

See also