ICLRDataTarget2 Interface

  • Article

A subclass of ICLRDataTarget that is used by the data access services layer to manipulate virtual memory regions in the target process.

interface ICLRDataTarget2 : ICLRDataTarget
{
    HRESULT AllocVirtual([in] CLRDATA_ADDRESS addr,
                         [in] ULONG32 size,
                         [in] ULONG32 typeFlags,
                         [in] ULONG32 protectFlags,
                         [out] CLRDATA_ADDRESS* virt);

    HRESULT FreeVirtual([in] CLRDATA_ADDRESS addr,
                        [in] ULONG32 size,
                        [in] ULONG32 typeFlags);
};

Methods

Method

Description

ICLRDataTarget2::AllocVirtual Method

Allocates memory in the address space of the target process.

ICLRDataTarget2::FreeVirtual Method

Frees memory that was previously allocated in the address space of the target process.

Remarks

The API client (that is, the debugger) must implement this interface as appropriate for the particular target process. For example, a live process would have an implementation different from that of a memory dump. The target may not support modification of its memory regions.

Requirements

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

Header: ClrData.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Concepts

ICLRDataTarget Interface

Debugging Interfaces