Udostępnij za pośrednictwem

ICorProfilerInfo3 — Interfejs

  • Artykuł

Udostępnia metody, których profilerzy kodu używają do komunikowania się ze środowiskiem uruchomieniowym języka wspólnego (CLR) w celu kontrolowania monitorowania zdarzeń i żądania informacji. Interfejs ICorProfilerInfo3 jest rozszerzeniem interfejsu ICorProfilerInfo2 . Udostępnia ona nowe metody obsługiwane w .NET Framework 4 i nowszych wersjach.

Metody

Metoda Opis
EnumJITedFunctions, metoda Zwraca moduł wyliczający dla wszystkich wcześniej skompilowanych funkcji JIT.
EnumModules, metoda Zwraca moduł wyliczający, który udostępnia metody sekwencyjnie iterujące przez kolekcję zarządzanych modułów, które są ładowane do aplikacji.
GetAppDomainsContainingModule, metoda Pobiera identyfikatory domen aplikacji, w których załadowano dany moduł.
GetFunctionEnter3Info, metoda Udostępnia ramkę stosu i informacje o argumentach funkcji zgłaszanej do profilera przez funkcję FunctionEnter3WithInfo ; może być wywoływany tylko podczas wywołania zwrotnego FunctionEnter3WithInfo .
GetFunctionLeave3Info, metoda Udostępnia ramkę stosu i wartość zwracaną funkcji zgłaszanej do profilera przez funkcję FunctionLeave3WithInfo ; może być wywoływany tylko podczas wywołania zwrotnego FunctionLeave3WithInfo .
GetFunctionTailcall3Info, metoda Udostępnia ramkę stosu funkcji zgłaszanej do profilera przez funkcję FunctionTailcall3WithInfo ; może być wywoływany tylko podczas wywołania zwrotnego FunctionTailcall3WithInfo .
GetModuleInfo2, metoda Biorąc pod uwagę identyfikator modułu, zwraca nazwę pliku modułu, identyfikator zestawu nadrzędnego modułu i maskę bitową opisową właściwości modułu.
GetRuntimeInformation, metoda Zawiera informacje o wersji środowiska uruchomieniowego, które jest profilowane.
GetStringLayout2, metoda Pobiera informacje o układzie obiektu ciągu.
GetThreadStaticAddress2, metoda Pobiera adres określonego pola statycznego wątku, który znajduje się w zakresie określonej domeny wątku i aplikacji.
RequestProfilerDetach, metoda Instruuje środowisko uruchomieniowe, aby odłączyło profilera.
SetEnterLeaveFunctionHooks3, metoda Określa funkcje implementowane przez profilera, które będą wywoływane w funkcjach FunctionEnter3, FunctionLeave3 i FunctionTailcall3 .
SetEnterLeaveFunctionHooks3WithInfo, metoda Określa funkcje zaimplementowane przez profilera, które będą wywoływane w funkcjiEnter3WithInfo, FunctionLeave3WithInfo i FunctionTailcall3WithInfo zaczepienia funkcji zarządzanych.
SetFunctionIDMapper2, metoda Określa funkcję zaimplementowaną przez profilera, która będzie wywoływana w celu mapowania FunctionID wartości na wartości alternatywne, które są przekazywane do wpisów/wyjścia funkcji profilera. Ta metoda rozszerza ICorProfilerInfo::SetFunctionIDMapper z parametrem, którego profilerzy mogą używać do uściślania między środowiskami uruchomieniowymi.

Uwagi

ClR implementuje metody interfejsu ICorProfilerInfo3 przy użyciu modelu bezwątkowej. Każda metoda zwraca wartość HRESULT, aby wskazać powodzenie lub niepowodzenie. Aby uzyskać listę możliwych kodów powrotnych, zobacz plik CorError.h.

ClR przekazuje ICorProfilerInfo3 interfejs do każdego profilera kodu podczas inicjowania przy użyciu implementacji profilera metody ICorProfilerCallback::Initialize lub ICorProfilerCallback3::InitializeForAttach . Profiler kodu może następnie wywołać ICorProfilerInfo3 metody, aby uzyskać informacje o kodzie zarządzanym wykonywanym pod kontrolą środowiska CLR.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorProf.idl, CorProf.h

Biblioteki: CorGuids.lib

wersje .NET Framework: dostępne od 4

Zobacz też