SymRegisterFunctionEntryCallbackProc64 Callback Function

Debug Help Library

SymRegisterFunctionEntryCallbackProc64 Callback Function

An application-defined callback function used with the SymRegisterFunctionEntryCallback64 function. It is called by the stack walking procedure.

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

PVOID CALLBACK SymRegisterFunctionEntryCallbackProc64(
  [in]                 HANDLE hProcess,
  [in]                 ULONG64 AddrBase,
  [in]                 ULONG64 UserContext
);

Parameters

hProcess

A handle to the process that was originally passed to the StackWalk64 function.

AddrBase

The address of an instruction for which the callback function should return a function table entry.

UserContext

The user-defined value specified in SymRegisterFunctionEntryCallback64, or NULL. Typically, this parameter is used by an application to pass a pointer to a data structure that lets the callback function establish some context.

Return Value

Return the value NULL if no function table entry is available.

On success, return a pointer to an IMAGE_RUNTIME_FUNCTION_ENTRY structure. Refer to the header file WinNT.h for the definition of this function.

Remarks

The structure must be returned in exactly the form it exists in the process being debugged. Some members may be pointers to other locations in the process address space. The ReadProcessMemoryProc64 callback function may be called to retrieve the information at these locations.

The calling application gets called through the registered callback function as a result of a call to the StackWalk64 function. The calling application must be prepared for the possible side effects that this can cause. If the application has only one callback function that is being used by multiple threads, then it may be necessary to synchronize some types of data access while in the context of the callback function.

This function is similar to the FunctionTableAccessProc64 callback function. The difference is that FunctionTableAccessProc64 returns an IMAGE_FUNCTION_ENTRY structure, while this function returns an IMAGE_RUNTIME_FUNCTION_ENTRY structure.

Requirements

Redistributable

Requires DbgHelp.dll 5.1 or later.

Header

Declared in DbgHelp.h.

See Also

DbgHelp FunctionsSymRegisterFunctionEntryCallback64


Send comments about this topic to Microsoft

Build date: 9/25/2007

© 2007 Microsoft Corporation. All rights reserved.