Windows Dev Center

Expand Minimize

ReadProcessMemoryProc64 callback function

An application-defined callback function used with the StackWalk64 function. It is called when StackWalk64 needs to read memory from the address space of the process.

The PREAD_PROCESS_MEMORY_ROUTINE64 type defines a pointer to this callback function. ReadProcessMemoryProc64 is a placeholder for the application-defined function name.

Syntax


BOOL CALLBACK ReadProcessMemoryProc64(
  _In_  HANDLE  hProcess,
  _In_  DWORD64 lpBaseAddress,
  _Out_ PVOID   lpBuffer,
  _In_  DWORD   nSize,
  _Out_ LPDWORD lpNumberOfBytesRead
);

Parameters

hProcess [in]

A handle to the process for which the stack trace is generated.

lpBaseAddress [in]

The base address of the memory to be read.

lpBuffer [out]

A pointer to a buffer that receives the memory to be read.

nSize [in]

The size of the memory to be read, in bytes.

lpNumberOfBytesRead [out]

A pointer to a variable that receives the number of bytes actually read.

Return value

If the function succeeds, the return value should be TRUE. If the function fails, the return value should be FALSE.

Remarks

In many cases, this function can best service the callback with a corresponding call to ReadProcessMemory.

This function should read as much of the requested memory as possible. The StackWalk64 function handles the case where only part of the requested memory is read.

This callback function supersedes the PREAD_PROCESS_MEMORY_ROUTINE callback function. PREAD_PROCESS_MEMORY_ROUTINE is defined as follows in Dbghelp.h.


#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PREAD_PROCESS_MEMORY_ROUTINE PREAD_PROCESS_MEMORY_ROUTINE64
#else
typedef
BOOL
(__stdcall *PREAD_PROCESS_MEMORY_ROUTINE)(
    __in HANDLE hProcess,
    __in DWORD lpBaseAddress,
    __out_bcount(nSize) PVOID lpBuffer,
    __in DWORD nSize,
    __out PDWORD lpNumberOfBytesRead
    );
#endif

Requirements

Redistributable

DbgHelp.dll 5.1 or later

Header

DbgHelp.h

See also

DbgHelp Functions
StackWalk64
ReadProcessMemory

 

 

Community Additions

ADD
Show:
© 2015 Microsoft