ICorProfilerCallback::Initialize Method

Called to initialize the code profiler whenever a new common language runtime (CLR) application is started.

HRESULT Initialize(
    [in] IUnknown     *pICorProfilerInfoUnk);

Parameters

  • pICorProfilerInfoUnk
    [in] Pointer to an IUnknown interface that the profiler must query for an ICorProfilerInfo interface pointer.

Remarks

The Initialize call is the only opportunity to enable (or disable) callbacks that are immutable. Once a callback is enabled by the Initialize call, it cannot be disabled later using ICorProfilerInfo::SetEventMask. The COR_PRF_MONITOR_IMMUTABLE value of the COR_PRF_MONITOR enumeration indicates which events are immutable.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Concepts

ICorProfilerCallback Interface

ICorProfilerCallback::Shutdown Method