Função de FunctionEnter

Artigo
08/08/2011

Notifica o profiler para que o controle está sendo passado para uma função.

Observação

O FunctionEnter função é preterida na.NET Framework versão 2.0 e o seu uso incorrerá a penalidade de desempenho.Use o FunctionEnter2 função em vez disso.

void __stdcall FunctionEnter (
    [in]  FunctionID funcID
);

Parâmetros

funcID
[in] O identificador da função à qual o controle é passado.

Comentários

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

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