PREAD_PROCESS_MEMORY_ROUTINE回调函数 (dbghelp.h)

项目
02/29/2024

与 StackWalk64 函数一起使用的应用程序定义的回调函数。当 StackWalk64 需要从进程的地址空间读取内存时，将调用它。

PREAD_PROCESS_MEMORY_ROUTINE64类型定义指向此回调函数的指针。 ReadProcessMemoryProc64 是应用程序定义的函数名称的占位符。

语法

PREAD_PROCESS_MEMORY_ROUTINE PreadProcessMemoryRoutine;

BOOL PreadProcessMemoryRoutine(
  [in]  HANDLE hProcess,
  [in]  DWORD lpBaseAddress,
  [out] PVOID lpBuffer,
  [in]  DWORD nSize,
  [out] PDWORD lpNumberOfBytesRead
)
{...}

参数

[in] hProcess

为其生成堆栈跟踪的进程句柄。

[in] lpBaseAddress

要读取的内存的基址。

[out] lpBuffer

指向接收要读取的内存的缓冲区的指针。

[in] nSize

要读取的内存的大小（以字节为单位）。

[out] lpNumberOfBytesRead

指向接收实际读取的字节数的变量的指针。

返回值

如果函数成功，则返回值应为 TRUE。如果函数失败，则返回值应为 FALSE。

注解

在许多情况下，此函数可以通过对 ReadProcessMemory 的相应调用来最好地为回调提供服务。

此函数应读取尽可能多的请求内存。 StackWalk64 函数处理仅读取部分请求的内存的情况。

此回调函数取代 PREAD_PROCESS_MEMORY_ROUTINE 回调函数。 PREAD_PROCESS_MEMORY_ROUTINE 在 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