Edit

ICorProfilerInfo5::GetEventMask2 Method

  • Article

[Supported in the .NET Framework 4.5.2 and later versions]

Gets the current event categories for which the profiler wants to receive notifications from the common language runtime (CLR). It provides functionality not provided by the ICorProfilerInfo::GetEventMask method.

Syntax

HRESULT GetEventMask2(  
        [out] DWORD* pdwEventsLow,  
        [out] DWORD* pdwEventsHigh  
);

Parameters

pdwEventsLow
[out] A pointer to a 4-byte value that specifies the categories of events. Each bit controls a different capability, behavior, or type of event. The bits are described in the COR_PRF_MONITOR enumeration.

pdwEventsHigh
[out] A pointer to a 4-byte value that specifies the categories of events. Each bit controls a different capability, behavior, or type of event. The bits are described in the COR_PRF_HIGH_MONITOR enumeration.

Remarks

The GetEventMask2 method is used to determine which callbacks the profiler has subscribed to. Typically, you perform a logical OR of the pdwEventsLow and pdwEventsHigh values and any new bits you want to set, and then call the SetEventMask2 method.

This method is the recommended alternative to the GetEventMask method.

Requirements

Platforms: See System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4.5.2

See also