Rediger

DacpGcHeapAnalyzeData Structure

Defines a transport buffer for garbage collection heap analysis information.

Note

This API was originally designed for internal use in the runtime. Although it is now supported for 3rd party use, we recommend working with ICorDebug and ICorProfiler APIs when possible.

Syntax

struct DacpGcHeapAnalyzeData
    : ZeroInit<DacpGcHeapAnalyzeData>
{
    CLRDATA_ADDRESS heapAddr; // Only filled in in server mode, otherwise NULL

    CLRDATA_ADDRESS internal_root_array;
    ULONG64         internal_root_array_index;
    BOOL            heap_analyze_success;

    // Use this for workstation mode (DacpGcHeapDat.bServerMode==FALSE).
    HRESULT Request(ISOSDacInterface *sos)
    {
        return sos->GetHeapAnalyzeStaticData(this);   
    }

    // Use this for Server mode, as there are multiple heaps,
    // and you need to pass a heap address in addr.
    HRESULT Request(ISOSDacInterface *sos, CLRDATA_ADDRESS addr)
    {
        return sos->GetHeapAnalyzeData(addr, this);
    }
};

Members

Member Description
heapAddr The address of the GC heap. This member is filled only in server mode; otherwise, it is NULL.
internal_root_array The address of the internal root array.
internal_root_array_index The index into the internal root array.
heap_analyze_success A value that indicates whether heap analysis succeeded.
Request Populates the structure by calling ISOSDacInterface::GetHeapAnalyzeStaticData or ISOSDacInterface::GetHeapAnalyzeData.

Remarks

This structure lives inside the runtime and is not exposed through any headers or library files. To use it, define the structure as specified above.

Requirements

Platforms: See System Requirements.
Header: None
Library: None
.NET Framework Versions: Available since 4.7

See also

  • Last updated on