ICorProfilerInfo-gränssnitt
Innehåller metoder som används av kodprofilerare för att kommunicera med CLR (Common Language Runtime) för att styra händelseövervakning och begära information.
Kommentar
Varje metod i ICorProfilerInfo gränssnittet returnerar en HRESULT för att indikera framgång eller fel. Se CorError.h för en lista över möjliga returkoder.
Metoder
| Metod | beskrivning |
|---|---|
| BeginInprocDebugging-metod | Initierar felsökningsstöd under processen. Den här metoden är föråldrad i .NET Framework version 2.0. |
| EndInprocDebugging-metod | Stänger av en pågående felsökningssession. Den här metoden är föråldrad i .NET Framework version 2.0. |
| ForceGC-metod | Tvingar skräpinsamling att ske inom körningen. |
| GetAppDomainInfo-metod | Hämtar information om den angivna programdomänen. |
| GetAssemblyInfo-metod | Hämtar information om den angivna sammansättningen. |
| GetClassFromObject-metod | Hämtar en ClassIDobjektet, med tanke på dess ObjectID. |
| GetClassFromToken-metod | Hämtar klassens ID med tanke på metadatatoken. Den här metoden är föråldrad i .NET Framework version 2.0. Använd metoden ICorProfilerInfo2::GetClassFromTokenAndTypeArgs i stället. |
| GetClassIDInfo-metod | Hämtar den överordnade modulen och metadatatoken för den angivna klassen. |
| GetCodeInfo-metod | Hämtar omfattningen av intern kod som är associerad med det angivna funktions-ID:t. Den här metoden är föråldrad. Använd metoden ICorProfilerInfo2::GetCodeInfo2 i stället. |
| GetCurrentThreadID-metod | Hämtar ID för den aktuella tråden, om det är en hanterad tråd. |
| GetEventMask-metod | Hämtar de aktuella händelsekategorier som profileraren vill ta emot händelsemeddelanden från CLR för. |
| GetFunctionFromIP-metod | Kartor en instruktionspekare för hanterad kod till en FunctionID. |
| GetFunctionFromToken-metod | Hämtar ID för en funktion. Den här metoden är föråldrad i .NET Framework version 2.0. Använd metoden ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs i stället. |
| GetFunctionInfo-metod | Hämtar den överordnade klassen och metadatatoken för den angivna funktionen. |
| GetHandleFromThread-metod | Kartor ID:t för en tråd till ett Win32-trådhandtag. |
| GetILFunctionBody-metod | Hämtar en pekare till brödtexten för en metod i CIL-kod (Common Intermediate Language) med början vid rubriken. |
| GetILFunctionBodyAllocator-metod | Hämtar ett gränssnitt som tillhandahåller en metod för att allokera minne som ska användas för att växla ut brödtexten för en metod i CIL-kod. |
| GetILToNativeMapping-metod | Hämtar en karta från CIL-förskjutningar till inbyggda förskjutningar för koden som finns i den angivna funktionen. |
| GetInprocInspectionInterface-metod | Hämtar ett objekt som kan efterfrågas för ett ICorDebugProcess-gränssnitt. Den här metoden är föråldrad i .NET Framework version 2.0. |
| GetInprocInspectionIThisThread-metoden | Hämtar ett objekt som kan efterfrågas för gränssnittet ICorDebugThread. Den här metoden är föråldrad i .NET Framework version 2.0. |
| GetModuleInfo-metod | Givet ett modul-ID returnerar filnamnet för modulen och ID:t för modulens överordnade sammansättning. |
| GetModuleMetaData-metod | Hämtar en instans av metadatagränssnittet som mappar till den angivna modulen. |
| GetObjectSize-metod | Hämtar storleken på ett angivet objekt. |
| GetThreadContext-metod | Hämtar kontextidentiteten som för närvarande är associerad med den angivna tråden. |
| GetThreadInfo-metod | Hämtar den aktuella Win32-trådidentiteten för den angivna tråden. |
| GetTokenAndMetadataFromFunction-metod | Hämtar metadatatoken och en instans av metadatagränssnittet som kan användas mot token för den angivna funktionen. |
| IsArrayClass-metod | Avgör om den angivna klassen är en matrisklass. |
| SetEnterLeaveFunctionHooks-metod | Anger profiler-implementerade funktioner som ska anropas på "enter", "leave" och "tailcall" hooks av hanterade funktioner. |
| SetEventMask-metod | Anger ett värde som anger de typer av händelser som profileraren vill ta emot meddelanden för från CLR. |
| SetFunctionIDMapper-metod | Anger den profiler-implementerade funktionen som ska anropas för att mappa FunctionID värden till alternativa värden, som skickas till profilerarens funktionsinmatnings-/utgångskrokar. |
| SetFunctionReJIT-metod | Inte implementerad. Använd inte. |
| SetILFunctionBody-metod | Ersätter brödtexten för den angivna funktionen i den angivna modulen. |
| SetILInstrumentedCodeMap-metod | Anger hur förskjutningarna för en angiven funktions ursprungliga CIL-mappning till de nya förskjutningarna av funktionens profilerade CIL. |
Kommentarer
En profilerare anropar en metod i ICorProfilerInfo gränssnittet för att kommunicera med CLR för att kontrollera händelseövervakning och begära information.
Metoderna i ICorProfilerInfo gränssnittet implementeras av CLR med hjälp av den fritrådade modellen. Varje metod returnerar en HRESULT för att indikera lyckad eller misslyckad. Se CorError.h för en lista över möjliga returkoder.
CLR skickar, via profilerarens implementering av ICorProfilerCallback::Initialize, ett ICorProfilerInfo gränssnitt till varje kodprofilerare under initieringen. En kodprofilerare kan sedan anropa metoder för ICorProfilerInfo gränssnittet för att hämta information om hanterad kod som körs under kontroll av CLR.
Krav
Plattformar: Se Systemkrav.
Rubrik: CorProf.idl, CorProf.h
Bibliotek: CorGuids.lib
.NET Framework-versioner: Tillgänglig sedan 2.0
