Método ICorProfilerInfo3::GetFunctionEnter3Info
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