Função de FunctionEnter3WithInfo

Artigo
08/08/2011

Notifica o profiler para que o controle está sendo passado para uma função e fornece um identificador que pode ser passado para o o método de ICorProfilerInfo3::GetFunctionEnter3Info para recuperar os argumentos de quadro e a função de pilha.

void __stdcall FunctionEnter3WithInfo(
               [in] FunctionIDOrClientID functionIDOrClientID,
               [in] COR_PRF_ELT_INFO eltInfo);

Parâmetros

functionIDOrClientID
[in] O identificador da função à qual o controle é passado.
eltInfo
[in] Identificador opaco que representa informações sobre um quadro de pilha determinado. Esse identificador é válido apenas durante o retorno de chamada para o qual é passado.

Comentários

O FunctionEnter3WithInfo o método de retorno de chamada notifica o profiler à medida que são chamadas de funções e permite que o profiler usar o o método de ICorProfilerInfo3::GetFunctionEnter3Info para inspecionar os valores de argumento. Para acessar informações de argumento, o COR_PRF_ENABLE_FUNCTION_ARGS sinalizador precisa ser definido. O profiler pode usar o o método de ICorProfilerInfo::SetEventMask para definir os sinalizadores de evento e, em seguida, use o ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo método para registrar a sua implementação desta função.

O FunctionEnter3WithInfo função é um retorno de chamada; Você deve implementá-la. A implementação deve usar o __declspec(naked) atributo de classe de armazenamento.

O mecanismo de execução não salva qualquer registradores antes de chamar essa função.

Na entrada, você deve salvar todos os registros que você utiliza, incluindo aqueles na unidade de ponto flutuante (FPU).
Ao sair, você deve restaurar a pilha popping desativar todos os parâmetros que foram enviados pelo seu chamador.

A implementação de FunctionEnter3WithInfo não deve bloquear, porque ele atrasará a coleta de lixo. A implementação não deve tentar uma coleta de lixo, porque a pilha não pode estar em um estado de amigável de coleta de lixo. Se a tentativa de uma coleta de lixo, o tempo de execução será bloqueado até que FunctionEnter3WithInfo retorna.

O FunctionEnter3WithInfo função não deve chamar código gerenciado ou causar uma alocação de memória gerenciada em qualquer forma.