Função FunctionLeave3WithInfo
Notifica o gerador de perfis de que o controlo está a ser devolvido a partir de uma função e fornece uma alça que pode ser transmitida para o método ICorProfilerInfo3::GetFunctionLeave3Info para obter a moldura da pilha e o valor devolvido.
Sintaxe
void __stdcall FunctionLeave3WithInfo(
[in] FunctionIDOrClientID functionIDOrClientID,
[in] COR_PRF_ELT_INFO eltInfo);
Parâmetros
functionIDOrClientID
[in] O identificador da função a partir da qual é devolvido o controlo.
eltInfo
[in] Uma alça opaca que representa informações sobre uma determinada moldura de pilha. Esta alça só é válida durante a chamada de retorno para a qual é transmitida.
Observações
O FunctionLeave3WithInfo
método de chamada de retorno notifica o profiler como as funções são chamadas e permite que o gerador de perfis utilize o método ICorProfilerInfo3::GetFunctionLeave3Info para inspecionar o valor devolvido. Para aceder às informações de valor devolvido, o COR_PRF_ENABLE_FUNCTION_RETVAL
sinalizador tem de ser definido. O profiler pode utilizar o método ICorProfilerInfo::SetEventMask para definir os sinalizadores de eventos e, em seguida, utilizar o método ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo para registar a implementação desta função.
A FunctionLeave3WithInfo
função é uma chamada de retorno; tem de implementá-la. A implementação tem de utilizar o __declspec(naked)
atributo da classe de armazenamento.
O motor de execução não guarda registos antes de chamar esta função.
À entrada, tem de guardar todos os registos que utiliza, incluindo os da unidade de vírgula flutuante (FPU).
Ao sair, tem de restaurar a pilha ao remover todos os parâmetros que foram emitidos pelo autor da chamada.
A implementação de FunctionLeave3WithInfo
não deve ser bloqueada, uma vez que irá atrasar a recolha de lixo. A implementação não deve tentar uma libertação de lixo, uma vez que a pilha pode não estar num estado compatível com a libertação da memória. Se for tentada uma libertação de lixo, o runtime bloqueará até FunctionLeave3WithInfo
ser devolvido.
A FunctionLeave3WithInfo
função não pode chamar para o código gerido ou causar uma alocação de memória gerida de qualquer forma.
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: CorProf.idl
Biblioteca: CorGuids.lib
.NET Framework Versões: Disponível desde 4