Função FunctionEnter
Notifica o criador de perfil de que o controle está sendo transmitido para uma função.
Observação
A função FunctionEnter
foi preterida no .NET Framework versão 2.0 e seu uso impactará negativamente o desempenho. Em vez disso, use a função FunctionEnter2.
Sintaxe
void __stdcall FunctionEnter (
[in] FunctionID funcID
);
Parâmetros
funcID
[in] O identificador da função para a qual o controle é transmitido.
Comentários
A função FunctionEnter
é um retorno de chamada e você deve implementá-la. A implementação precisa usar o atributo __declspec
(naked
) da classe de armazenamento.
O mecanismo de execução não salva nenhum registro antes de chamar essa função.
Na entrada, você precisa salvar todos os registros usados, incluindo aqueles na FPU (unidade de ponto flutuante).
Na saída, você deve restaurar a pilha removendo todos os parâmetros que foram enviados por push pelo chamador.
A implementação de FunctionEnter
não deve ser bloqueada porque atrasará a coleta de lixo. A implementação não deve tentar fazer uma coleta de lixo porque a pilha pode não estar em um estado adequado para a coleta de lixo. Se houver uma tentativa de coleta de lixo, o runtime será bloqueado até retornar FunctionEnter
.
Além disso, a função FunctionEnter
não deve chamar o código gerenciado ou de alguma forma causar uma alocação de memória gerenciada.
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: CorProf.idl
Biblioteca: CorGuids.lib
Versões do .NET Framework: 1.1, 1.0