Compartilhar via

Método ICorProfilerInfo3::GetFunctionEnter3Info

  • Artigo

Fornece o registro de ativação e as informações de argumento da função que está sendo relatada ao criador de perfil pela função FunctionEnter3WithInfo. Esse método só pode ser chamado durante o retorno de chamada FunctionEnter3WithInfo.

Sintaxe

HRESULT GetFunctionEnter3Info(  
            [in]  FunctionID functionId,
            [in]  COR_PRF_ELT_INFO eltInfo,  
            [out] COR_PRF_FRAME_INFO *pFrameInfo,  
            [in, out] ULONG *pcbArgumentInfo,  
            [out, size_is(*pcbArgumentInfo)]  
                  COR_PRF_FUNCTION_ARGUMENT_INFO *pArgumentInfo);

Parâmetros

functionId
[in] A função FunctionID que está retornando.

eltInfo
[in] Um identificador opaco que representa informações sobre um dado registro de ativação. O criador de perfil deve fornecer o mesmo eltInfo que foi fornecido pela função FunctionEnter3WithInfo.

pFrameInfo
[out] Um identificador opaco que representa informações genéricas sobre um dado registro de ativação. Esse identificador é válido somente durante o retorno de chamada FunctionEnter3WithInfo no qual o criador de perfil chamou o método GetFunctionEnter3Info.

pcbArgumentInfo
[in, out] Um ponteiro para o tamanho total, em bytes, da estrutura COR_PRF_FUNCTION_ARGUMENT_INFO (mais quaisquer estruturas COR_PRF_FUNCTION_ARGUMENT_RANGE adicionais para os intervalos de argumentos apontados por pArgumentInfo). Se o tamanho especificado não for suficiente, ERROR_INSUFFICIENT_BUFFER será retornado e o tamanho esperado será armazenado em pcbArgumentInfo. Para chamar GetFunctionEnter3Info apenas para recuperar o valor esperado para *pcbArgumentInfo. Defina *pcbArgumentInfo=0 e pArgumentInfo=NULL.

pArgumentInfo
[out] Um ponteiro para uma estrutura COR_PRF_FUNCTION_ARGUMENT_INFO que descreve os locais dos argumentos da função na memória, na ordem da esquerda para a direita.

Comentários

O criador de perfil deve alocar espaço suficiente para a estrutura COR_PRF_FUNCTION_ARGUMENT_INFO da função que está sendo inspecionada e deve indicar o tamanho no parâmetro pcbArgumentInfo.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4

Confira também