função de retorno de chamada PFUNCTION_TABLE_ACCESS_ROUTINE (dbghelp.h)

Artigo
08/23/2023

Uma função de retorno de chamada definida pelo aplicativo usada com a função StackWalk64 . Ele fornece acesso à tabela de funções em tempo de execução para o processo.

O tipo PFUNCTION_TABLE_ACCESS_ROUTINE64 define um ponteiro para essa função de retorno de chamada. FunctionTableAccessProc64 é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PFUNCTION_TABLE_ACCESS_ROUTINE PfunctionTableAccessRoutine;

PVOID PfunctionTableAccessRoutine(
  [in] HANDLE hProcess,
  [in] DWORD AddrBase
)
{...}

Parâmetros

[in] hProcess

Um identificador para o processo para o qual o rastreamento de pilha é gerado.

[in] AddrBase

O endereço da instrução a ser localizada.

Valor retornado

A função retorna um ponteiro para a tabela de funções em tempo de execução. Em um computador x86, esse é um ponteiro para uma estrutura FPO_DATA . Em um computador Alfa, esse é um ponteiro para uma estrutura IMAGE_FUNCTION_ENTRY .

Comentários

Essa função de retorno de chamada substitui a função de retorno de chamada PFUNCTION_TABLE_ACCESS_ROUTINE. PFUNCTION_TABLE_ACCESS_ROUTINE é definido da seguinte maneira em DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PFUNCTION_TABLE_ACCESS_ROUTINE PFUNCTION_TABLE_ACCESS_ROUTINE64
#else
typedef
PVOID
(__stdcall *PFUNCTION_TABLE_ACCESS_ROUTINE)(
    __in HANDLE hProcess,
    __in DWORD AddrBase
    );
#endif