Método ICorProfilerInfo3::SetFunctionIDMapper2

Artigo
05/10/2023

Especifica a função implementada pelo criador de perfil que será chamada para mapear valores FunctionID para valores alternativos, que são passados para os ganchos de entrada/saída da função do criador de perfil. Esse método estende o método ICorProfilerInfo::SetFunctionIDMapper com um parâmetro de dados adicional, que os profilers podem usar para desambiguar entre runtimes.

Sintaxe

HRESULT SetFunctionIDMapper2(  
       [in] FunctionIDMapper2 *pFunc,  
       [in] void *clientData);

Parâmetros

pFunc
[in] Um ponteiro para uma implementação FunctionIDMapper2 que será chamada para mapear os valores FunctionID para seus valores alternativos.

clientData
[in] Um ponteiro que é passado para cada chamada de função FunctionIDMapper2 feita pelo runtime atual. O criador de perfil pode usar essas informações para desambiguar entre runtimes.

Valor Retornado

Comentários

As alternativas para os valores functionID serão passadas para os ganchos de entrada/saída de função do criador de perfil (FunctionEnter3, FunctionLeave3 e FunctionTailcall3; ou FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo) especificados pelo método SetEnterLeaveFunctionHooks3 ou SetEnterLeaveFunctionHooks3WithInfo.

O método FunctionIDMapper2 pode ser definido apenas uma vez e recomendamos defini-lo no retorno de chamada ICorProfilerCallback::Initialize.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4

Compartilhar via