Поделиться через

Метод ICorProfilerInfo::GetILToNativeMapping

  • Статья

Получает карту из смещения общего промежуточного языка (CIL) на собственные смещения для кода, содержащегося в указанной функции.

Синтаксис

HRESULT GetILToNativeMapping(
    [in] FunctionID functionId,
    [in] ULONG32 cMap,
    [out] ULONG32 *pcMap,
    [out, size_is(cMap), length_is(*pcMap)]
        COR_DEBUG_IL_TO_NATIVE_MAP map[]);

Параметры

functionId [in] Идентификатор функции, содержащей код.

cMap [in] Максимальный размер массива map .

pcMap [out] Общее количество доступных COR_DEBUG_IL_TO_NATIVE_MAP структур.

map [out] Массив COR_DEBUG_IL_TO_NATIVE_MAP структур, каждый из которых задает смещения. После возврата метода GetILToNativeMapping параметр map будет содержать все или некоторые из структур COR_DEBUG_IL_TO_NATIVE_MAP.

Замечания

Метод GetILToNativeMapping возвращает массив структур COR_DEBUG_IL_TO_NATIVE_MAP. Чтобы передать, что определенные диапазоны собственных инструкций соответствуют специальным областям кода (например, прологу), запись в массиве может иметь значение ilOffset значения перечисления CorDebugIlToNativeMappingTypes.

После возврата метода GetILToNativeMapping необходимо убедиться, что буфер map был достаточно велик, чтобы вместить в себя все структуры COR_DEBUG_IL_TO_NATIVE_MAP. Для этого сравните значение параметра cMap со значением параметра pcMap. Если значение pcMap, умноженное на размер структуры COR_DEBUG_IL_TO_NATIVE_MAPCOR_PRF_CODE_INFO, больше значения cMap, выделите буфер map большего размера, обновите параметр cMap, задав новый, больший размер, и вызовите метод GetILToNativeMapping снова.

Кроме того, сначала можно вызвать метод GetILToNativeMapping с буфером map нулевой длины для получения правильного размера буфера. Затем можно задать размер буфера равным значению, возвращенному в параметре pcMap, и вызвать метод GetILToNativeMapping снова.

Требования

Платформы: см. раздел Требования к системе.

Заголовок: CorProf.idl, CorProf.h

Библиотека: CorGuids.lib

версии платформа .NET Framework: Доступно с версии 2.0

См. также