PGET_MODULE_BASE_ROUTINE callback function (dbghelp.h)

Article
08/09/2022

An application-defined callback function used with the StackWalk64 function. It is called when StackWalk64 needs a module base address for a given virtual address.

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

Syntax

PGET_MODULE_BASE_ROUTINE PgetModuleBaseRoutine;

DWORD PgetModuleBaseRoutine(
  [in] HANDLE hProcess,
  [in] DWORD Address
)
{...}

Parameters

[in] hProcess

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

[in] Address

An address within the module image to be located.

Return value

The function returns the base address of the module.

Remarks

This callback function supersedes the PGET_MODULE_BASE_ROUTINE callback function. PGET_MODULE_BASE_ROUTINE is defined as follows in DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PGET_MODULE_BASE_ROUTINE PGET_MODULE_BASE_ROUTINE64
#else
typedef
DWORD
(__stdcall *PGET_MODULE_BASE_ROUTINE)(
    __in HANDLE hProcess,
    __in DWORD Address
    );
#endif

Requirements

Requirement	Value
Target Platform	Windows
Header	dbghelp.h
Redistributable	DbgHelp.dll 5.1 or later