Partilhar via

Função FunctionEnter2

Notifica o gerador de perfis de que o controlo está a ser transmitido para uma função e fornece informações sobre os argumentos da moldura da pilha e da função. Esta função substitui a função FunctionEnter .

Sintaxe

void __stdcall FunctionEnter2 (  
    [in]  FunctionID                       funcId,
    [in]  UINT_PTR                         clientData,
    [in]  COR_PRF_FRAME_INFO               func,
    [in]  COR_PRF_FUNCTION_ARGUMENT_INFO  *argumentInfo  
);

Parâmetros

funcId [in] O identificador da função para a qual o controlo é transmitido.

clientData [in] O identificador de função remapado, que o gerador de perfis especificou anteriormente com a função FunctionIDMapper .

func [in] Um COR_PRF_FRAME_INFO valor que aponta para informações sobre a moldura da pilha.

O gerador de perfis deve tratar isto como uma alça opaca que pode ser transmitida de volta para o motor de execução no método ICorProfilerInfo2::GetFunctionInfo2 .

argumentInfo [in] Um ponteiro para uma estrutura COR_PRF_FUNCTION_ARGUMENT_INFO que especifica as localizações na memória dos argumentos da função.

Para aceder às informações do argumento, o COR_PRF_ENABLE_FUNCTION_ARGS sinalizador tem de ser definido. O gerador de perfis pode utilizar o método ICorProfilerInfo::SetEventMask para definir os sinalizadores de eventos.

Observações

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

A FunctionEnter2 função é uma chamada de retorno; tem de implementá-la. A implementação tem de utilizar o __declspecatributo da classe de armazenamento (naked).

O motor de execução não guarda quaisquer 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 retirar todos os parâmetros que foram emitidos pelo autor da chamada.

A implementação de FunctionEnter2 não deve bloquear porque atrasará a libertação da memória. A implementação não deve tentar uma libertação da memória porque a pilha pode não estar num estado amigável de libertação da memória. Se for tentada uma libertação da memória, o runtime bloqueará até FunctionEnter2 ser devolvido.

Além disso, a FunctionEnter2 função não pode chamar para código gerido ou, de qualquer forma, causar uma alocação de memória gerida.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: CorProf.idl

Biblioteca: CorGuids.lib

.NET Framework Versões: Disponível desde 2.0

Ver também

  • Last updated on