Share via

ICorProfilerInfo3::GetFunctionEnter3Info-Methode

  • Artikel

Stellt den Stapelrahmen und die Argumentinformationen der Funktion bereit, die dem Profiler von der FunctionEnter3WithInfo-Funktion gemeldet wird. Diese Methode kann nur während des FunctionEnter3WithInfo-Rückrufs aufgerufen werden.

Syntax

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

Parameter

functionId
[in] Die FunctionID der Funktion, die aufgerufen wird.

eltInfo
[in] Ein nicht transparentes Handle, das Informationen über einen bestimmten Stapelrahmen entspricht. Der Profiler muss dieselbe eltInfo bereitstellen, die ihm durch die FunctionEnter3WithInfo-Funktion übergeben wurde.

pFrameInfo
[out] Ein nicht transparentes Handle, das Genericsinformationen zu einem bestimmten Stapelrahmen entspricht. Dieses Handle ist nur während des FunctionEnter3WithInfo-Rückrufs gültig, in dem der Profiler die GetFunctionEnter3Info-Methode aufgerufen hat.

pcbArgumentInfo
[in, out] Ein Zeiger auf die Gesamtgröße (in Bytes) der COR_PRF_FUNCTION_ARGUMENT_INFO-Struktur (sowie alle weiteren COR_PRF_FUNCTION_ARGUMENT_RANGE-Strukturen für die Argumentbereiche, auf die pArgumentInfo zeigt). Wenn die angegebene Größe nicht ausreichend ist, wird ERROR_INSUFFICIENT_BUFFER zurückgegeben, und die erwartete Größe wird in pcbArgumentInfo gespeichert. Um GetFunctionEnter3Info so aufzurufen, dass nur der erwartete Wert für *pcbArgumentInfo abgerufen wird, legen *pcbArgumentInfo= 0 und pArgumentInfo= NULL fest.

pArgumentInfo
[out] Ein Zeiger auf eine COR_PRF_FUNCTION_ARGUMENT_INFO-Struktur, in der in Links-nach-rechts-Reihenfolge die Positionen beschrieben sind, die die Argumente der Funktion im Arbeitsspeicher haben.

Bemerkungen

Der Profiler muss genügend Speicherplatz für die COR_PRF_FUNCTION_ARGUMENT_INFO-Struktur der Funktion reservieren, die geprüft wird, und er muss die Größe im pcbArgumentInfo-Parameter angeben.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: seit Version 4 verfügbar

Weitere Informationen