IHostMAlloc Interface

  • Article

Provides methods that allow the common language runtime (CLR) to request fine-grained allocations from the heap through the host.

interface IHostMalloc : IUnknown {
    HRESULT Alloc (
        [in] SIZE_T cbSize, 
        [in] EMemoryCriticalLevel dwCriticalLevel, 
        [out] void** ppMem
    );
    HRESULT DebugAlloc (
        [in] SIZE_T cbSize, 
        [in] EMemoryCriticalLevel dwCriticalLevel, 
        [in] char* pszFileName, 
        [in] int iLineNo, 
        [out] void** ppMem
    );
    HRESULT Free (
        [in] void* pMem
    );
}

Methods

Method

Description

IHostMAlloc::Alloc Method

Requests that the host allocate the requested amount of memory from the heap.

IHostMAlloc::DebugAlloc Method

Requests that the host allocate the requested amount of memory from the heap, and additionally track where the memory was allocated.

IHostMAlloc::Free Method

Frees memory that was allocated by using the Alloc method.

Remarks

The CLR gets an interface pointer to an IHostMalloc instance by calling the IHostMemoryManager::CreateMAlloc method.

Requirements

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

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 2.0

See Also

Concepts

IHostMemoryManager Interface

Hosting Interfaces