Partilhar via


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

Ver também