Função de FunctionLeave2

Artigo
08/08/2011

Notifica o criador de perfil que uma função retornar ao chamador e fornece informações sobre a pilha quadro e a função valor de retorno.

void __stdcall FunctionLeave2 (
    [in]  FunctionID                        funcId,
    [in]  UINT_PTR                          clientData,
    [in]  COR_PRF_FRAME_INFO                func,
    [in]  COR_PRF_FUNCTION_ARGUMENT_RANGE  *retvalRange
);

Parâmetros

funcId
[in] O identificador da função que está retornando.
clientData
[in] O identificador de função remapeados, o criador de perfil especificado anteriormente via o FunctionIDMapper função.
func
[in] A COR_PRF_FRAME_INFO valor que aponta para informações sobre o quadro de pilha.

O profiler deve tratar isso como um identificador opaco que pode ser passado de volta para o mecanismo de execução na ICorProfilerInfo2::GetFunctionInfo2 método.
retvalRange
[in] Um ponteiro para uma COR_PRF_FUNCTION_ARGUMENT_RANGE estrutura que especifica o local de memória do valor de retorno da função.

Para acessar informações de valor de retorno, o COR_PRF_ENABLE_FUNCTION_RETVAL sinalizador deve ser definido. O profiler pode usar o ICorProfilerInfo::SetEventMask método para definir os sinalizadores de evento.

Comentários

Os valores a func e retvalRange parâmetros não são válidos após a FunctionLeave2 função retorna porque os valores podem ser alterados ou destruídos.

O FunctionLeave2 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 FunctionLeave2 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 FunctionLeave2 retorna.

Além disso, o FunctionLeave2 função não deve chamar código gerenciado ou em qualquer causa de forma uma alocação de memória gerenciada.