Share via


ICorDebugProcess::ReadMemory Method

Reads a specified area of memory for this process.

HRESULT ReadMemory(
    [in] CORDB_ADDRESS address, 
    [in] DWORD size,
    [out, size_is(size), length_is(size)] BYTE buffer[],
    [out] SIZE_T *read);

Parameters

Parameter Description

address

[in] A CORDB_ADDRESS value that specifies the base address of the memory to be read.

size

[in] The number of bytes to be read from memory.

buffer

[out] A buffer that receives the contents of the memory.

read

[out] A pointer to the number of bytes transferred into the specified buffer.

Remarks

The ReadMemory method is primarily intended to be used by interop debugging to inspect memory regions that are being used by the unmanaged portion of the debuggee. This method can also be used to read Microsoft intermediate language (MSIL) code and native JIT-compiled code.

Any managed breakpoints will be removed from the data that is returned in the buffer parameter. No adjustments will be made for native breakpoints set by ICorDebugProcess2::SetUnmanagedBreakpoint Method.

No caching of process memory is performed.

Requirements

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

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0, 1.1, 1.0

See Also

Reference

ICorDebugProcess Interface
ICorDebugProcess2 Interface