Função de FunctionLeave3WithInfo

Artigo
08/08/2011

Notifica o profiler para que o controle está sendo retornado de uma função e fornece um identificador que pode ser passado para o o método de ICorProfilerInfo3::GetFunctionLeave3Info para recuperar o quadro de pilha e o valor de retorno.

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

Parâmetros

functionIDOrClientID
[in] O identificador da função a partir do qual o controle é retornado.
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 FunctionLeave3WithInfo 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::GetFunctionLeave3Info para inspecionar o valor de retorno. Para acessar informações de valor de retorno, o COR_PRF_ENABLE_FUNCTION_RETVAL 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 FunctionLeave3WithInfo 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 FunctionLeave3WithInfo 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 FunctionLeave3WithInfo retorna.

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