PTRANSLATE_ADDRESS_ROUTINE callback function (dbghelp.h)

Article
02/22/2024

An application-defined callback function used with the StackWalk64 function. It provides address translation for 16-bit addresses.

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

Syntax

PTRANSLATE_ADDRESS_ROUTINE PtranslateAddressRoutine;

DWORD PtranslateAddressRoutine(
  [in] HANDLE hProcess,
  [in] HANDLE hThread,
  [in] LPADDRESS lpaddr
)
{...}

Parameters

[in] hProcess

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

[in] hThread

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

[in] lpaddr

An address to be translated.

Return value

The function returns the translated address.

Remarks

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PTRANSLATE_ADDRESS_ROUTINE PTRANSLATE_ADDRESS_ROUTINE64
#else
typedef
DWORD
(__stdcall *PTRANSLATE_ADDRESS_ROUTINE)(
    __in HANDLE hProcess,
    __in HANDLE hThread,
    __out LPADDRESS lpaddr
    );
#endif

Requirements

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