Функция FunctionEnter2

Статья
08/11/2011

Уведомляет профилировщик о передаче управления функции и предоставляет сведения о кадре стека и аргументах функции. Эта функция замещает функцию FunctionEnter.

void __stdcall FunctionEnter2 (
    [in]  FunctionID                       funcId, 
    [in]  UINT_PTR                         clientData, 
    [in]  COR_PRF_FRAME_INFO               func, 
    [in]  COR_PRF_FUNCTION_ARGUMENT_INFO  *argumentInfo
);

Параметры

funcId
[in] Идентификатор функции, которому предается элемент управления.
clientData
[in] Повторно сопоставленный идентификатор функции, который был задан ранее профилировщиком с помощью функции FunctionIDMapper.
func
[in] Значение COR_PRF_FRAME_INFO, указывающее на сведения о кадре стека.

Профилировщик должен интерпретировать его как непрозрачный дескриптор, который может быть передан назад в ядро выполнения в методе ICorProfilerInfo2::GetFunctionInfo2.
argumentInfo
[in] Указатель на структуру COR_PRF_FUNCTION_ARGUMENT_INFO, которая задает расположение аргументов функции в памяти.

Для доступа к сведениям об аргументах нужно установить флаг COR_PRF_ENABLE_FUNCTION_ARGS. Профилировщик может задать флаги значения с помощью метода ICorProfilerInfo::SetEventMask.

Заметки

Значения параметров func и argumentInfo становятся недопустимыми после возврата значения функции FunctionEnter2, поскольку они могут быть изменены или удалены.

Функция FunctionEnter2 является функцией обратного вызова; ее следует реализовать. В реализации должен использоваться атрибут класса памяти __declspec(naked).

Перед вызовом этой функции ядро выполнения не сохраняет значения регистров.

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

Реализация функции FunctionEnter2 не должна осуществлять блокировку, поскольку это приведет к задержке сборки мусора. При реализации не следует предпринимать попытку сборки мусора, поскольку стек может находиться в состоянии, не поддерживающем этот процесс. Если предпринимается попытка выполнения сборки мусора, среда выполнения будет блокироваться до тех пор, пока функция FunctionEnter2 не возвратит значение.

Кроме того, функция FunctionEnter2 не должна вызывать управляемый код или каким-либо образом инициировать управляемое распределение памяти.

Требования

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

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

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

Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0