Método ICorProfilerInfo3::GetFunctionEnter3Info
Fornece a moldura de pilha e as informações de argumento da função que está a ser comunicada ao gerador de perfis pela função FunctionEnter3WithInfo . Este método só pode ser chamado durante a FunctionEnter3WithInfo
chamada de retorno.
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] O FunctionID
da função que está a ser introduzida.
eltInfo
[in] Uma alça opaca que representa informações sobre uma determinada moldura de pilha. O gerador de perfis deve fornecer o mesmo eltInfo
que foi dado pela função FunctionEnter3WithInfo .
pFrameInfo
[fora] Uma alça opaca que representa informações genéricas sobre uma determinada moldura de pilha. Este identificador só é válido durante a FunctionEnter3WithInfo
chamada de retorno na qual o gerador de perfis chamou o GetFunctionEnter3Info
método .
pcbArgumentInfo
[dentro, fora] Um ponteiro para o tamanho total, em bytes, da estrutura COR_PRF_FUNCTION_ARGUMENT_INFO (além de quaisquer estruturas de 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 é devolvido e o tamanho esperado é armazenado em pcbArgumentInfo
. Para chamar GetFunctionEnter3Info
apenas para obter o valor esperado para *pcbArgumentInfo
, defina *pcbArgumentInfo
=0 e pArgumentInfo
=NULL.
pArgumentInfo
[fora] Um ponteiro para uma estrutura COR_PRF_FUNCTION_ARGUMENT_INFO que descreve as localizações dos argumentos da função na memória, por ordem da esquerda para a direita.
Observações
O gerador de perfis tem de alocar espaço suficiente para a COR_PRF_FUNCTION_ARGUMENT_INFO
estrutura da função que está a ser inspecionada e tem de indicar o tamanho no pcbArgumentInfo
parâmetro .
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: CorProf.idl, CorProf.h
Biblioteca: CorGuids.lib
.NET Framework Versões: Disponível desde 4