ICorProfilerInfo — Interfejs
Udostępnia metody używane przez profilery kodu do komunikowania się ze środowiskiem uruchomieniowym języka wspólnego (CLR) w celu kontrolowania monitorowania zdarzeń i żądania informacji.
Uwaga
Każda metoda w interfejsie ICorProfilerInfo zwraca wartość HRESULT, aby wskazać powodzenie lub niepowodzenie. Aby uzyskać listę możliwych kodów powrotnych, zobacz CorError.h.
Metody
| Metoda | opis |
|---|---|
| BeginInprocDebugging, metoda | Inicjuje obsługę debugowania w procesie. Ta metoda jest przestarzała w programie .NET Framework w wersji 2.0. |
| EndInprocDebugging, metoda | Zamyka sesję debugowania w procesie. Ta metoda jest przestarzała w programie .NET Framework w wersji 2.0. |
| ForceGC, metoda | Wymusza odzyskiwanie pamięci w czasie wykonywania. |
| GetAppDomainInfo, metoda | Pobiera informacje o określonej domenie aplikacji. |
| GetAssemblyInfo, metoda | Pobiera informacje o określonym zestawie. |
| GetClassFromObject, metoda | Pobiera element ClassIDobiekt, biorąc pod uwagę jego ObjectIDwartość . |
| GetClassFromToken, metoda | Pobiera identyfikator klasy, biorąc pod uwagę token metadanych. Ta metoda jest przestarzała w programie .NET Framework w wersji 2.0. Zamiast tego użyj metody ICorProfilerInfo2::GetClassFromTokenAndTypeArgs. |
| GetClassIDInfo, metoda | Pobiera moduł nadrzędny i token metadanych dla określonej klasy. |
| GetCodeInfo, metoda | Pobiera zakres kodu natywnego skojarzonego z określonym identyfikatorem funkcji. Ta metoda jest przestarzała. Zamiast tego użyj metody ICorProfilerInfo2::GetCodeInfo2. |
| GetCurrentThreadID, metoda | Pobiera identyfikator bieżącego wątku, jeśli jest to zarządzany wątek. |
| GetEventMask, metoda | Pobiera bieżące kategorie zdarzeń, dla których profiler chce otrzymywać powiadomienia o zdarzeniach z CLR. |
| GetFunctionFromIP, metoda | Mapy wskaźnik instrukcji zarządzanego kodu do .FunctionID |
| GetFunctionFromToken, metoda | Pobiera identyfikator funkcji. Ta metoda jest przestarzała w programie .NET Framework w wersji 2.0. Zamiast tego użyj metody ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs. |
| GetFunctionInfo, metoda | Pobiera klasę nadrzędną i token metadanych dla określonej funkcji. |
| GetHandleFromThread, metoda | Mapy identyfikator wątku do uchwytu wątku Win32. |
| GetILFunctionBody, metoda | Pobiera wskaźnik do treści metody w kodzie wspólnego języka pośredniego (CIL), zaczynając od nagłówka. |
| GetILFunctionBodyAllocator, metoda | Pobiera interfejs, który udostępnia metodę przydzielania pamięci, która ma być używana do zamiany treści metody w kodzie CIL. |
| GetILToNativeMapping, metoda | Pobiera mapę z przesunięcia CIL na natywne przesunięcia dla kodu zawartego w określonej funkcji. |
| GetInprocInspectionInterface, metoda | Pobiera obiekt, którego można odpytować dla interfejsu ICorDebugProcess. Ta metoda jest przestarzała w programie .NET Framework w wersji 2.0. |
| GetInprocInspectionIThisThread, metoda | Pobiera obiekt, którego można odpytować dla interfejsu ICorDebugThread. Ta metoda jest przestarzała w programie .NET Framework w wersji 2.0. |
| GetModuleInfo, metoda | Biorąc pod uwagę identyfikator modułu, zwraca nazwę pliku modułu i identyfikator zestawu nadrzędnego modułu. |
| GetModuleMetaData, metoda | Pobiera wystąpienie interfejsu metadanych mapujące się na określony moduł. |
| GetObjectSize, metoda | Pobiera rozmiar określonego obiektu. |
| GetThreadContext, metoda | Pobiera tożsamość kontekstu skojarzona obecnie z określonym wątkiem. |
| GetThreadInfo, metoda | Pobiera bieżącą tożsamość wątku Win32 dla określonego wątku. |
| GetTokenAndMetadataFromFunction, metoda | Pobiera token metadanych i wystąpienie interfejsu metadanych, które mogą być używane względem tokenu dla określonej funkcji. |
| IsArrayClass, metoda | Określa, czy określona klasa jest klasą tablicy. |
| SetEnterLeaveFunctionHooks, metoda | Określa funkcje implementowane przez profilera, które mają być wywoływane na "enter", "leave" i "tailcall" haki funkcji zarządzanych. |
| SetEventMask, metoda | Ustawia wartość określającą typy zdarzeń, dla których profiler chce otrzymywać powiadomienia z CLR. |
| SetFunctionIDMapper, 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. |
| SetFunctionReJIT, metoda | Nie zaimplementowano. Nie używaj. |
| SetILFunctionBody, metoda | Zastępuje treść określonej funkcji w określonym module. |
| SetILInstrumentedCodeMap, metoda | Określa sposób przesunięcia oryginalnej mapy CIL określonej funkcji na nowe przesunięcia profilera zmodyfikowanego wzornika funkcji. |
Uwagi
Profiler wywołuje metodę w interfejsie ICorProfilerInfo , aby komunikować się z CLR w celu kontrolowania monitorowania zdarzeń i żądania informacji.
Metody interfejsu ICorProfilerInfo są implementowane przez CLR przy użyciu modelu bezwątkowy. Każda metoda zwraca wartość HRESULT, aby wskazać powodzenie lub niepowodzenie. Aby uzyskać listę możliwych kodów powrotnych, zobacz CorError.h.
ClR przechodzi przez implementację profilera ICorProfilerCallback::Initialize, ICorProfilerInfo interfejs do każdego profilera kodu podczas inicjowania. Profiler kodu może następnie wywoływać metody interfejsu ICorProfilerInfo , aby uzyskać informacje o kodzie zarządzanym wykonywanym pod kontrolą środowiska CLR.
Wymagania
Platformy: zobacz Wymagania systemowe.
Nagłówek: CorProf.idl, CorProf.h
Biblioteka: CorGuids.lib
Wersje programu .NET Framework: dostępne od wersji 2.0
