ICorProfilerInfo3::GetFunctionEnter3Info-Methode

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

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 begonnen wird.

• eltInfo
  [in] Ein nicht transparentes Handle, das Informationen zu einem angegebenen Stapelrahmen darstellt. Der Profiler muss die gleiche eltInfo bereitstellen, die für ihn von der FunctionEnter3WithInfo-Funktion angegeben wurde.

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

• pcbArgumentInfo
  [in, aus] Ein Zeiger auf der Anzahl der Argumente, die an die Funktion übergeben werden, an die die Steuerung übergegangen ist.

• pArgumentInfo
  [out] Ein Zeiger auf eine COR_PRF_FUNCTION_ARGUMENT_INFO-Struktur, die die Positionen für die Argumente der Funktion im Arbeitsspeicher von links nach rechts beschreibt.

Hinweise

Der Profiler muss genügend Speicher für die COR_PRF_FUNCTION_ARGUMENT_INFO-Struktur der zu überprüfenden Funktion reservieren und die Größe im pcbArgumentInfo-Parameter angeben.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: 4

Siehe auch

Referenz

FunctionEnter3WithInfo

FunctionLeave3WithInfo

FunctionTailcall3WithInfo

ICorProfilerInfo3-Schnittstelle

Konzepte

Profilerstellungs- und Laufzeitbenachrichtigungs-IDs

Weitere Ressourcen

Profilerstellungsschnittstellen

Profilerstellung (Referenz zur nicht verwalteten API)