Metodo ICorProfilerInfo3::GetFunctionEnter3InfoICorProfilerInfo3::GetFunctionEnter3Info Method

Fornisce le informazioni sullo stack frame e l'argomento della funzione da segnalare al profiler tramite la FunctionEnter3WithInfo (funzione).Provides the stack frame and argument information of the function that is being reported to the profiler by the FunctionEnter3WithInfo function. Questo metodo può essere chiamato solo durante il callback FunctionEnter3WithInfo.This method can be called only during the FunctionEnter3WithInfo callback.

SintassiSyntax

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);  

ParametriParameters

functionId
[in] FunctionID della funzione da immettere.[in] The FunctionID of the function that is being entered.

eltInfo
[in] Handle opaco che rappresenta le informazioni su un determinato stack frame.[in] An opaque handle that represents information about a given stack frame. Il profiler deve fornire la stessa eltInfo che fornito il FunctionEnter3WithInfo (funzione).The profiler should provide the same eltInfo that it was given by the FunctionEnter3WithInfo function.

pFrameInfo
[out] Handle opaco che rappresenta le informazioni sui generics relative a un determinato stack frame.[out] An opaque handle that represents generics information about a given stack frame. Questo handle è valido solo durante il callback FunctionEnter3WithInfo in cui il profiler ha chiamato il metodo GetFunctionEnter3Info.This handle is valid only during the FunctionEnter3WithInfo callback in which the profiler called the GetFunctionEnter3Info method.

pcbArgumentInfo
[in, out] Un puntatore alla dimensione totale, espressa in byte, del COR_PRF_FUNCTION_ARGUMENT_INFO struttura (più eventuali altre COR_PRF_FUNCTION_ARGUMENT_RANGE strutture per gli intervalli di argomenti a cui puntati pArgumentInfo).[in, out] A pointer to the total size, in bytes, of the COR_PRF_FUNCTION_ARGUMENT_INFO structure (plus any additional COR_PRF_FUNCTION_ARGUMENT_RANGE structures for the argument ranges pointed to by pArgumentInfo). Se la dimensione specificata non è sufficiente, viene restituito ERROR_INSUFFICIENT_BUFFER e la dimensione prevista viene archiviata in pcbArgumentInfo.If the specified size is not enough, ERROR_INSUFFICIENT_BUFFER is returned and the expected size is stored in pcbArgumentInfo. Per chiamare GetFunctionEnter3Info per recuperare il valore previsto per *pcbArgumentInfo, impostare *pcbArgumentInfo=0 e pArgumentInfo=NULL.To call GetFunctionEnter3Info just to retrieve the expected value for *pcbArgumentInfo, set *pcbArgumentInfo=0 and pArgumentInfo=NULL.

pArgumentInfo
[out] Un puntatore a un COR_PRF_FUNCTION_ARGUMENT_INFO struttura che descrive le posizioni degli argomenti della funzione in memoria, in ordine da sinistra a destra.[out] A pointer to a COR_PRF_FUNCTION_ARGUMENT_INFO structure that describes the locations of the function's arguments in memory, in left-to-right order.

NoteRemarks

Il profiler deve allocare spazio sufficiente per la struttura COR_PRF_FUNCTION_ARGUMENT_INFO della funzione che viene esaminata e deve indicare la dimensione nel parametro pcbArgumentInfo.The profiler must allocate sufficient space for the COR_PRF_FUNCTION_ARGUMENT_INFO structure of the function that is being inspected, and must indicate the size in the pcbArgumentInfo parameter.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: CorProf.idl, CorProf.hHeader: CorProf.idl, CorProf.h

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: Disponibile dalla 4Available since 4.NET Framework Versions: Disponibile dalla 4Available since 4

Vedere ancheSee Also

FunctionEnter3WithInfoFunctionEnter3WithInfo
FunctionLeave3WithInfoFunctionLeave3WithInfo
FunctionTailcall3WithInfoFunctionTailcall3WithInfo
Interfaccia ICorProfilerInfo3ICorProfilerInfo3 Interface
Interfacce di profilaturaProfiling Interfaces
ProfilaturaProfiling