Partilhar via

Função FunctionIDMapper2

  • Artigo

Notifica o gerador de perfis de que o identificador especificado de uma função pode ser remapeado para um ID alternativo a ser utilizado nas chamadas FunctionEnter3, FunctionLeave3 e FunctionTailcall3 ouFunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo para essa função. FunctionIDMapper2 também permite que o gerador de perfis indique se quer receber chamadas de retorno para essa função.

Sintaxe

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

Parâmetros

funcId [in] O identificador de função a ser remapeado.

clientData [in] Um ponteiro para dados utilizados para desambiguar entre runtimes.

pbHookFunction[fora] Um ponteiro para um valor que o gerador de perfis define como true se pretende receber FunctionEnter3, FunctionLeave3e , ou FunctionTailcall3FunctionEnter3WithInfo, FunctionLeave3WithInfoe FunctionTailcall3WithInfo chamadas de retorno; caso contrário, define este valor como false.

Devolver Valor

O gerador de perfis devolve um valor que o motor de execução utiliza como identificador de função alternativo. O valor devolvido não pode ser nulo, a menos que false seja devolvido em pbHookFunction. Caso contrário, um valor devolvido nulo produz resultados imprevisíveis, incluindo possivelmente parar o processo.

Observações

Este método expande a função FunctionIDMapper com um parâmetro adicional que é utilizado para transmitir dados de cliente. Os dados do cliente são utilizados para desambiguar entre runtimes.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: CorProf.idl

Biblioteca: CorGuids.lib

.NET Framework Versões: Disponível desde 4

Ver também