Metodo ICorProfilerInfo3::GetFunctionEnter3Info

  • Articolo

Fornisce le informazioni sullo stack frame e sull'argomento della funzione segnalata al profiler dalla funzione FunctionEnter3WithInfo . Questo metodo può essere chiamato solo durante il callback FunctionEnter3WithInfo.

Sintassi

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

Parametri

functionId
[in] FunctionID della funzione da immettere.

eltInfo
[in] Handle opaco che rappresenta le informazioni su un determinato stack frame. Il profiler deve fornire lo stesso eltInfo dato dalla funzione FunctionEnter3WithInfo .

pFrameInfo
[out] Handle opaco che rappresenta le informazioni sui generics relative a un determinato stack frame. Questo handle è valido solo durante il callback FunctionEnter3WithInfo in cui il profiler ha chiamato il metodo GetFunctionEnter3Info.

pcbArgumentInfo
[in, out] Puntatore alla dimensione totale, in byte, della struttura COR_PRF_FUNCTION_ARGUMENT_INFO (più eventuali strutture COR_PRF_FUNCTION_ARGUMENT_RANGE aggiuntive per gli intervalli di argomenti a pArgumentInfocui punta ). Se la dimensione specificata non è sufficiente, viene restituito ERROR_INSUFFICIENT_BUFFER e la dimensione prevista viene archiviata in pcbArgumentInfo. Per chiamare GetFunctionEnter3Info per recuperare il valore previsto per *pcbArgumentInfo, impostare *pcbArgumentInfo=0 e pArgumentInfo=NULL.

pArgumentInfo
[out] Puntatore a una struttura COR_PRF_FUNCTION_ARGUMENT_INFO che descrive le posizioni degli argomenti della funzione in memoria, in ordine da sinistra a destra.

Commenti

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.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile da 4

Vedi anche