ICorProfilerInfo3 — Interfejs
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
