ICorProfilerCallback::ObjectsAllocatedByClass Method

Notifies the profiler about the number of instances of each specified class that have been created since the most recent garbage collection.

Syntax

HRESULT ObjectsAllocatedByClass(  
    [in] ULONG   cClassCount,  
    [in, size_is(cClassCount)] ClassID classIds[] ,  
    [in, size_is(cClassCount)] ULONG   cObjects[] );  

Parameters

cClassCount
[in] The size of the classIds and cObjects arrays.

classIds
[in] An array of class IDs, where each ID specifies a class with one or more instances.

cObjects
[in] An array of integers, where each integer specifies the number of instances for the corresponding class in the classIds array.

Remarks

The classIds and cObjects arrays are parallel arrays. For example, classIds[i] and cObjects[i] reference the same class. If no instance of a class has been created since the previous garbage collection, the class is omitted. The ObjectsAllocatedByClass callback will not report objects allocated in the large object heap.

The numbers reported by ObjectsAllocatedByClass are only estimates. For exact counts, use ICorProfilerCallback::ObjectAllocated.

The classIds array may contain one or more null entries if the corresponding cObjects array has types that are unloading.

Requirements

Platforms: See System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0

See also