Função de FunctionIDMapper2

Artigo
08/08/2011

Notifica o profiler para que o identificador especificado de uma função pode ser remapeado para uma identificação alternativa a ser usado na FunctionEnter3, FunctionLeave3, e FunctionTailcall3, ouFunctionEnter3WithInfo, FunctionLeave3WithInfo, e FunctionTailcall3WithInfo retornos de chamada para essa função. FunctionIDMapper2também permite que o profiler indicar se deseja receber retornos de chamada para essa função.

UINT_PTR __stdcall FunctionIDMapper2 (
    [in]  FunctionID  funcId,
    [in]  void * clientData,
    [out] BOOL       *pbHookFunction
);

Parâmetros

funcId
[in] O identificador da função ser remapeados.
clientData
[in] Um ponteiro para dados que são usados para remover a ambigüidade entre os tempos de execução.
pbHookFunction
[out] Um ponteiro para um valor que define o profiler true se deseja receber FunctionEnter3, FunctionLeave3, e FunctionTailcall3, ouFunctionEnter3WithInfo, FunctionLeave3WithInfo, e FunctionTailcall3WithInfo retornos de chamada; Caso contrário, ele define esse valor como false.

Valor de retorno

O profiler retorna um valor que o mecanismo de execução usa como um identificador de função alternativos. O valor de retorno não pode ser nulo, a menos que false é retornado em pbHookFunction. Caso contrário, um valor de retorno nulo produz resultados imprevisíveis, incluindo possivelmente interromper o processo.

Comentários

Esse método amplia o Função de FunctionIDMapper função com um parâmetro adicional é usada para passar dados de cliente. Os dados do cliente são usados para remover a ambigüidade entre os tempos de execução.