Função de FunctionTailcall2

Artigo
08/08/2011

Notifica o criador de perfil que a função atualmente em execução está prestes a realizar uma chamada de cauda para outra função e fornece informações sobre o quadro de pilha.

void __stdcall FunctionTailcall2 (
    [in] FunctionID         funcId, 
    [in] UINT_PTR           clientData, 
    [in] COR_PRF_FRAME_INFO func
);

Parâmetros

funcId
[in] O identificador da função atualmente em execução que está prestes a fazer um Laço de chamada.
clientData
[in] O identificador de função remapeados, o criador de perfil especificado anteriormente via FunctionIDMapper, da função atualmente em execução que está prestes a fazer um Laço de chamada.
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.

Comentários

A função de destino da chamada de Laço usará o quadro de pilha atual e voltará diretamente para o chamador da função que fez a cauda de chamada. Isso significa que uma FunctionLeave2 retorno de chamada não será emitido para uma função que é o destino de uma chamada tail.

O valor da func parâmetro não é válido após a FunctionTailcall2 função retorna porque o valor podem ser alterados ou destruído.

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

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