Sdílet prostřednictvím


DkmClrNcModuleInstance Třída

Definice

DkmClrNcModuleInstance se používá pro spravované moduly, které jsou zkompilovány do nativního kódu a vloženy uvnitř nativního modulu. Podobně jako DkmClrModuleInstance jsou tyto hodnoty 1:1 s ICorDebugModule.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6).

public ref class DkmClrNcModuleInstance : Microsoft::VisualStudio::Debugger::Clr::DkmClrModuleInstance
[System.Runtime.InteropServices.Guid("f85a173b-616b-91d3-319d-24cf9030c023")]
public class DkmClrNcModuleInstance : Microsoft.VisualStudio.Debugger.Clr.DkmClrModuleInstance
[<System.Runtime.InteropServices.Guid("f85a173b-616b-91d3-319d-24cf9030c023")>]
type DkmClrNcModuleInstance = class
    inherit DkmClrModuleInstance
Public Class DkmClrNcModuleInstance
Inherits DkmClrModuleInstance
Dědičnost
Dědičnost
Atributy

Vlastnosti

AppDomain

DkmClrAppDomain představuje doménu aplikace CLR uvnitř procesu, který se ladí.

(Zděděno od DkmClrModuleInstance)
BaseAddress

[Volitelné] Počáteční adresa paměti, kam se modul načetl. Pokud modul nenačetl souvislý blok paměti, bude tato hodnota nulová.

(Zděděno od DkmModuleInstance)
ClrFlags

Příznaky označující vlastnosti instance DkmModuleInstance načtené clr.

(Zděděno od DkmClrModuleInstance)
Connection

To představuje připojení mezi monitorováním a integrovaným vývojovém prostředím. Může se jednat o místní připojení, pokud monitorování běží ve stejném procesu jako integrované vývojové prostředí (IDE), nebo může být vzdálené připojení. V procesu monitorování existuje pouze jedno připojení.

(Zděděno od DkmModuleInstance)
ContainerModule

Instance kontejneru (fyzického) modulu, do které je tento vložený (virtuální) modul integrovaný.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6).

Flags

Příznaky označující vlastnosti DkmModuleInstance.

(Zděděno od DkmModuleInstance)
FullName

Plně kvalifikovaný název modulu. U modulů založených na souborech se jedná o úplnou cestu k modulu (např. c:\windows\system32\kernel32.dll.

(Zděděno od DkmModuleInstance)
ILImageSize

Určuje velikost obrázku IL tohoto modulu, protože se týká vyhledávání symbolů serveru. V případě desktopového rozhraní .NET Framework se tím určí velikost image IL, která se bude lišit od velikosti nezpracované image v případě ngen. Je to proto, že na serverech symbolů se indexuje pouze obrázek IL. Pro .NET Core ngen a připraveno ke spuštění se tím určí velikost nezpracované image, protože image ngen/ready to run je to, co se indexuje, a nechceme provádět vyhledávání na základě pouze velikosti image IL.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

(Zděděno od DkmClrModuleInstance)
Index

Identifikátor tohoto vloženého modulu v kontejneru. Používá se jako předpona názvů typů v modulu kontejneru k označení, do kterého vloženého modulu typ patří.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6).

IsDisabled

Označuje, jestli byla tato instance modulu zakázána. Zakázané moduly ladicí program do značné míry ignoruje. U nativních modulů se rozsah adres zakázaného modulu považuje za nenamapovaný. U modulů CLR jsou všechny rámce z těchto modulů skryté ze zásobníku volání.

(Zděděno od DkmModuleInstance)
IsUnloaded

Vrátí hodnotu true, pokud byla pro tento objekt vyvolána událost unloaded (příklad: DkmThread::Unload je volána) nebo pokud byl objekt uzavřen. Mějte na paměti, že při kontrole tohoto stavu je potřeba střídmět, protože bez synchronizace nemusí být vrácený stav po přečtení přesný.

(Zděděno od DkmDataContainer)
LoadContext

Řetězcový popis kontextu, pod kterým byl tento modul načten. Příklad: Win32 nebo CLR v2.0.50727: Výchozí doména.

(Zděděno od DkmModuleInstance)
LoadOrder

Celočíselný počet instancí modulu, které byly načteny do a včetně tohoto modulu. Každá instance modulu runtime sleduje vlastní počet pořadí načítání.

(Zděděno od DkmModuleInstance)
MemoryLayout

Výčet určující, jak je modul rozložen v paměti.

(Zděděno od DkmModuleInstance)
MinidumpInfoPart

[Volitelné] 'MinidumpInfoPart' se používá ke sdělení dalších informací o modulech v DkmProcess pro minidump.

(Zděděno od DkmModuleInstance)
Module

[Volitelné] Reprezentace modulu (DkmModule) obslužné rutiny symbolu, který je přidružen k této instanci modulu. Tato hodnota má zpočátku hodnotu null a je přiřazena, pokud a kdy jsou symboly přidruženy k této instanci modulu.

(Zděděno od DkmModuleInstance)
Mvid

Identifikátor tohoto vloženého modulu v rámci procesu.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

Mvid

Identifikátor verze modulu z načteného modulu. Jedná se o jedinečnou hodnotu, která je vložena do exe/dll linkery/kompilátory při sestavení dll/exe. Při každé kompilaci knihovny DLL/exe se vygeneruje nová hodnota.

(Zděděno od DkmClrModuleInstance)
Name

Stručné znázornění názvu modulu U modulů založených na souborech se jedná o název souboru a příponu (např. kernel32.dll).

(Zděděno od DkmModuleInstance)
Process

DkmProcess představuje cílový proces, který se ladí. Ladicí program ladí procesy, takže se jedná o základní jednotku ladění. DkmProcess může představovat systémový proces nebo virtuální proces, například minidumps.

(Zděděno od DkmModuleInstance)
RuntimeInstance

Představuje nativní zkompilovanou instanci CLR spuštěnou v cílovém procesu.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6).

Size

[Volitelné] Počet bajtů v oblasti paměti modulu. Pokud modul nenačetl souvislý blok paměti, bude tato hodnota nulová.

(Zděděno od DkmModuleInstance)
SymbolFileId

[Volitelné] Obsahuje informace potřebné k vyhledání symbolů pro tento modul. Ve Win32 jsou tyto informace obsaženy v IMAGE_DEBUG_DIRECTORY.

(Zděděno od DkmModuleInstance)
TagValue

DkmModuleInstance je abstraktní základní třída. Tento výčet označuje, které odvozené třídy je tento objekt instancí.

(Zděděno od DkmModuleInstance)
TimeDateStamp

Datum a čas sestavení načteného modulu. Tato hodnota se získá z IMAGE_NT_HEADERS načteného modulu. Měrná jednotka je hodnota FILETIME, což je 64bitová hodnota představující počet intervalů 100 nanosekund od 1. ledna 1601 (UTC).

(Zděděno od DkmModuleInstance)
UniqueId

Jedinečně identifikuje objekt DkmModuleInstance.

(Zděděno od DkmModuleInstance)
Version

[Volitelné] Informace o verzi souboru.

(Zděděno od DkmModuleInstance)

Metody

CanDecompileMethod(DkmClrMethodId)

Poskytuje informace o tom, zda lze dekompilovat zadanou metodu.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

(Zděděno od DkmClrModuleInstance)
CanDecompileModule(DkmDecompilerMode)

Poskytuje informace o tom, zda lze modul dekompilovat v daném režimu.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).

(Zděděno od DkmClrModuleInstance)
ClearTransitionModuleFlag()

Instance modulu runtime volají tuto metodu k označení modulu jako hraničního modulu. Při krokování by moduly runtime měly zkontrolovat, jestli krok narazil na modul hranice, a zahájit krokování rozhodčího řízení, pokud ano. Upozorňujeme, že některé moduly runtime nemusí být schopny tomuto požadavku vyhovět. Dispečer bude uchovávat počet volání FlagAsTransitionModule. Pouze v případě odpovídajícího počtu volání ClearTransitionModuleFlag nebude modul již považován za přechodový modul.

Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000).

(Zděděno od DkmModuleInstance)
CreateInstructionAddressesFromILAddress(DkmWorkList, DkmClrMethodId, UInt32, DkmCompletionRoutine<DkmCreateInstructionAddressesFromILAddressAsyncResult>)

Vytvoří jeden nebo více DkmClrNcInstructionAddress z tokenu metody + IL offset. Pokud se posun IL mapuje na více bloků instrukcí nebo pokud se jedná o obecnou metodu a existuje více instancí, může existovat více adres.

Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6).

Decompile()

Dekompiluje kód modulu do jazyka C# a vytvoří nový přenosný soubor PDB s tímto vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 5 (DkmApiVersion.VS16Update5).

(Zděděno od DkmModuleInstance)
Decompile(DkmDecompilerMode, String, Int32)

Dekompilace kódu modulu do jazyka C# a vytvoření nového přenosného souboru PDB s vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly. Implementace by měly vrátit S_OK o selhání a skutečné hodnoty HRESULT a jakékoli další informace o chybách prostřednictvím parametrů HR a ErrorMessage.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).

(Zděděno od DkmClrModuleInstance)
Decompile(DkmWorkList, DkmCompletionRoutine<DkmDecompileAsyncResult>)

Dekompiluje kód modulu do jazyka C# a vytvoří nový přenosný soubor PDB s tímto vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 16 Update 5 (DkmApiVersion.VS16Update5).

(Zděděno od DkmModuleInstance)
Decompile(DkmWorkList, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

Dekompilace kódu modulu do jazyka C# a vytvoření nového přenosného souboru PDB s vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly. Implementace by měly vrátit S_OK o selhání a skutečné hodnoty HRESULT a jakékoli další informace o chybách prostřednictvím parametrů HR a ErrorMessage.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3).

(Zděděno od DkmModuleInstance)
Decompile(DkmWorkList, DkmDecompilerMode, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

Dekompilace kódu modulu do jazyka C# a vytvoření nového přenosného souboru PDB s vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly. Implementace by měly vrátit S_OK o selhání a skutečné hodnoty HRESULT a jakékoli další informace o chybách prostřednictvím parametrů HR a ErrorMessage.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).

(Zděděno od DkmClrModuleInstance)
Decompile(String, Int32)

Dekompilace kódu modulu do jazyka C# a vytvoření nového přenosného souboru PDB s vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly. Implementace by měly vrátit S_OK o selhání a skutečné hodnoty HRESULT a jakékoli další informace o chybách prostřednictvím parametrů HR a ErrorMessage.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3).

(Zděděno od DkmModuleInstance)
DecompileDocument(DkmWorkList, String, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

Dekompiliuje kód dokumentu do jazyka C# a aktualizuje soubor symbolů přidružený k modulu, který obsahuje, potřebnými informacemi o ladění a vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly. Implementace by měly vrátit S_OK o selhání a skutečné hodnoty HRESULT a jakékoli další informace o chybách prostřednictvím parametrů HR a ErrorMessage.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

(Zděděno od DkmClrModuleInstance)
DecompileDocument(String, String, Int32)

Dekompiliuje kód dokumentu do jazyka C# a aktualizuje soubor symbolů přidružený k modulu, který obsahuje, potřebnými informacemi o ladění a vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly. Implementace by měly vrátit S_OK o selhání a skutečné hodnoty HRESULT a jakékoli další informace o chybách prostřednictvím parametrů HR a ErrorMessage.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

(Zděděno od DkmClrModuleInstance)
DecompileMethods(DkmWorkList, ReadOnlyCollection<DkmClrMethodId>, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

Zkompiluje kód metod do jazyka C# a aktualizuje soubor symbolů přidružený k modulu, který obsahuje, potřebnými informacemi o ladění a vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly. Implementace by měly vrátit S_OK o selhání a skutečné hodnoty HRESULT a jakékoli další informace o chybách prostřednictvím parametrů HR a ErrorMessage.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

(Zděděno od DkmClrModuleInstance)
DecompileMethods(ReadOnlyCollection<DkmClrMethodId>, String, Int32)

Zkompiluje kód metod do jazyka C# a aktualizuje soubor symbolů přidružený k modulu, který obsahuje, potřebnými informacemi o ladění a vloženým zdrojem. Všechny moduly, které sdílejí tento soubor symbolů, začnou používat tyto aktualizované symboly. Implementace by měly vrátit S_OK o selhání a skutečné hodnoty HRESULT a jakékoli další informace o chybách prostřednictvím parametrů HR a ErrorMessage.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

(Zděděno od DkmClrModuleInstance)
FlagAsTransitionModule()

Instance modulu runtime volají tuto metodu k označení modulu jako hraničního modulu. Při krokování by moduly runtime měly zkontrolovat, jestli krok nenarazil na modul hranice, a pokud ano, zahájit krokování arbitráže. Upozorňujeme, že některé moduly runtime nemusí být schopny tento požadavek dodržet. Dispečer bude uchovávat počet volání. Pouze v případě, že byl proveden odpovídající počet volání ClearTransitionModuleFlag, modul již nebude považován za přechodový modul.

Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 100 000).

(Zděděno od DkmModuleInstance)
GetAssemblyImageBytes(UInt32, UInt32)

Vrátí bajty obrázku začínající na zadaném RVA. Implementoval zprostředkovatel symbolů pro spravovanou dm.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6).

GetBaselineMetaDataBytes()

Získá základní bajty metadat CLR z daného modulu.

Toto rozhraní API bylo představeno v sadě Visual Studio 15 Update 5 (DkmApiVersion.VS15Update5).

(Zděděno od DkmClrModuleInstance)
GetBaselineMetaDataBytesPtr(UInt32)

Získejte ukazatel na původní nezpracovaná metadata bajtů pro daný modul.

Omezení umístění: Žádné.

Toto rozhraní API bylo představeno v sadě Visual Studio 15 Update 5 (DkmApiVersion.VS15Update5).

(Zděděno od DkmClrModuleInstance)
GetCorObject()

Poskytuje přímý přístup k objektu ICorDebugModule, který vyhodnocovače výrazů nebo jiné komponenty můžou použít ke kontrole domény aplikace.

Vrácené rozhraní lze použít POUZE ke kontrole cílového procesu a NIKDY by se nemělo používat k řízení provádění (žádné krokování, žádné zarážky, žádné pokračování atd.). Tento postup se nepodporuje a bude mít za následek nedefinované chování.

Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 100 000).

(Zděděno od DkmClrModuleInstance)
GetDataItem<T>()

Získá instanci T, která byla přidána do této instance kontejneru. Pokud tento kontejner neobsahuje "T", vrátí tato funkce hodnotu null.

(Zděděno od DkmDataContainer)
GetEncAvailability(String)

Zkontroluje, jestli je pro odpovídající instanci spravovaného modulu podporovaná možnost Upravit a pokračovat.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 16 Update 1 (DkmApiVersion.VS16Update1).

(Zděděno od DkmClrModuleInstance)
GetEncILDelta(Int32)

Zodpovídá za dotazování rozdílu IL přidruženého k instanci modulu CLR. Rozdíly IL jsou výsledné bajty ze změny kódu, což může mít vliv na několik metod. Vilová sada to využívá při dotazování na informace o změněné metodě v rámci modulu.

Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 16 Update 3 (DkmApiVersion.VS16Update3).

(Zděděno od DkmClrModuleInstance)
GetGPUDisassembly(UInt64, UInt32, Boolean, Boolean)

Získejte demontáž rozsahu adres v instanci modulu ladění.

(Zděděno od DkmModuleInstance)
GetGPUDisassemblySize()

Vrátí velikost zpětného překladu v instanci modulu ladění.

(Zděděno od DkmModuleInstance)
GetLocalSignatureToken(Int32)

Získá token podpisu pro podpis místní proměnné zadanou token metody.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

(Zděděno od DkmClrModuleInstance)
GetMetaDataBytes()

Získá bajty metadat CLR z daného modulu. Tyto bajty lze pak předat IMetaDataDispenser::OpenScope k dekódování metadat.

(Zděděno od DkmClrModuleInstance)
GetMetaDataBytesPtr(UInt32)

Získejte ukazatel na nezpracovaná metadata bajtů pro daný modul.

POZNÁMKA: Tato hodnota ukazatele bude neplatná, pokud/když je modul a) uvolněn nebo b) změněn. Zjištění těchto scénářů: a) Přidejte do instance modulu položku dat. Ukazatel bude neplatný po zavolání metody OnClose (při uvolnění instance modulu). b) Implementujte IDkmClrModuleModifiedNotification.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

(Zděděno od DkmClrModuleInstance)
GetMetaDataFileInfo(Boolean, UInt32, UInt32)

Získá informace potřebné ke čtení metadat přímo ze souboru na disku.

Toto rozhraní API bylo představeno v sadě Visual Studio 16 Update 2 (DkmApiVersion.VS16Update2).

(Zděděno od DkmClrModuleInstance)
GetMetaDataImport()

Získá metadata CLR z daného modulu. Další informace o metadatech najdete v dokumentaci IMetaDataImport na webu MSDN.

POZNÁMKA: Volající musí při využívání tohoto rozhraní API ze spravovaného kódu věnovat velkou pozornost. Implementace IMetaDataImport může obsahovat popisovač souboru ladicího souboru a popisovač souboru bude uzavřen pouze v případě, že počet odkazů modelu COM dosáhne nuly. Proto musí být ručně uvolněn (Marshal.IsComObject + Marshal.ReleaseComObject) místo čekání na uvolňování paměti, aby zjistil, že objekt lze uvolnit. Při testování se ujistěte, že ladicí soubor obsahuje alespoň 64 kB metadat, protože čtečka metadat nebude při práci s malými soubory uchovávat soubor uzamčený pro čtení.

(Zděděno od DkmClrModuleInstance)
GetMetadataStatus()

Získání stavu metadat

Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

(Zděděno od DkmClrModuleInstance)
GetMethodTokens(DkmWorkList, String, String, DkmCompletionRoutine<DkmGetMethodTokensAsyncResult>)

Poskytuje mechanismus pro získání tokenů metadat pro metodu danou třídu. Ekvivalent K IMetaDataImport::EnumMethodsWithName.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

(Zděděno od DkmClrModuleInstance)
GetMethodTokens(String, String, Int32[])

Poskytuje mechanismus pro získání tokenů metadat pro metodu danou třídu. Ekvivalent K IMetaDataImport::EnumMethodsWithName.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

(Zděděno od DkmClrModuleInstance)
GetNextGPUInstructionAddress(UInt64)

Vrátí adresu další instrukce vzhledem k počáteční adrese.

(Zděděno od DkmModuleInstance)
GetSymbolLoadInformation()

Vrátí řetězec popisující různá umístění, ve kterých se symboly hledaly, a výsledek kontroly tohoto umístění. Tyto informace slouží k naplnění informací o načtení symbolů v okně modulů.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

(Zděděno od DkmModuleInstance)
GetSymbolSearchResult()

Načte všechny výsledky hledání symbolů přidružené k této instanci modulu.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3).

(Zděděno od DkmModuleInstance)
GetSymbolSearchResult(DkmWorkList, DkmCompletionRoutine<DkmGetSymbolSearchResultAsyncResult>)

Načte všechny výsledky hledání symbolů přidružené k této instanci modulu.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3).

(Zděděno od DkmModuleInstance)
GetSymbolStatusMessage(Boolean)

Získejte lokalizovaný řetězec popis aktuálního stavu symbolu.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

(Zděděno od DkmModuleInstance)
GetSymbolStatusMessage(DkmWorkList, Boolean, DkmCompletionRoutine<DkmGetSymbolStatusMessageAsyncResult>)

Získejte lokalizovaný řetězec popis aktuálního stavu symbolu.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

(Zděděno od DkmModuleInstance)
GetSymUnmanagedReader()

Toto rozhraní API poskytuje částečnou implementaci ISymUnmanagedReader2 pro modul CLR.

Omezení umístění: Poskytuje částečnou implementaci ISymUnmanagedReader2 na obou stranách vzdáleného připojení.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

(Zděděno od DkmClrModuleInstance)
GetTypeIdForTypeName(String)

Vrátí ID typu pro název daného typu.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8).

(Zděděno od DkmClrModuleInstance)
InterpretManagedMethod(DkmClrMethodId, ReadOnlyCollection<DkmClrType>, ReadOnlyCollection<DkmClrType>, DkmILInterpreterValue, ReadOnlyCollection<DkmILInterpreterValue>, Int32, DkmILInterpreterOptions, String)

Simuluje spuštění metody na objektu interpretací kódu MSIL metody. Výsledek metody se vrátí zpět volajícímu. Na rozdíl od vyhodnocení funkce, ve kterém je metoda ve skutečnosti spuštěna v cíli, však interpretace metody ve skutečnosti nespustí metodu, ale místo toho pouze simuluje chování metody. Vzhledem k tomu, že metoda se nikdy ve skutečnosti nespustí, všechny vedlejší účinky vyplývající z provádění metody jsou po dokončení interpretace metody zahozeny, takže cílový proces zůstane ve stejném stavu jako před voláním.

Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

(Zděděno od DkmClrModuleInstance)
IsSuppressed()

Tato metoda umožňuje komponentě určit, jestli byla událost načtení modulu pro modul potlačena.

Toto rozhraní API bylo představeno v sadě Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3).

(Zděděno od DkmModuleInstance)
IsTransitionModule()

Vrátí hodnotu true, pokud některá instance modulu runtime označila tento modul jako přechodový modul.

Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 100 000).

(Zděděno od DkmModuleInstance)
IsUserCode()

Určuje, jestli je modul považován za uživatelský kód.

Omezení umístění: Tuto metodu je možné volat ze komponenty integrovaného vývojového prostředí (IDE). Od Visual Studio 2013 aktualizaci Update 2 je také možné tuto funkci volat z komponenty monitorování pro spravovaný kód. V sadě Visual Studio 2017 Update 8 se callDirection rozhraní API změnilo na obousměrný směr z normálního rozhraní a teď se dá volat z libovolné komponenty, AsyncCaller byl nastaven na true a CallerLocationConstraint byl nastaven na hodnotu None z NoMarshalling.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

(Zděděno od DkmModuleInstance)
IsUserCode(DkmWorkList, DkmCompletionRoutine<DkmModuleInstanceIsUserCodeAsyncResult>)

Určuje, jestli je modul považován za uživatelský kód.

Tato metoda připojí novou pracovní položku k zadanému pracovnímu seznamu a vrátí se po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající obdrží oznámení o dokončení žádosti prostřednictvím rutiny dokončení.

Omezení umístění: Tuto metodu je možné volat ze komponenty integrovaného vývojového prostředí (IDE). Od Visual Studio 2013 aktualizaci Update 2 je také možné tuto funkci volat z komponenty monitorování pro spravovaný kód. V sadě Visual Studio 2017 Update 8 se callDirection rozhraní API změnilo na obousměrný směr z normálního rozhraní a teď se dá volat z libovolné komponenty, AsyncCaller byl nastaven na true a CallerLocationConstraint byl nastaven na hodnotu None z NoMarshalling.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

(Zděděno od DkmModuleInstance)
OnBinaryLoaded(String)

Vytvořte Událost BinaryLoaded. Součásti, které implementují rozhraní jímky událostí, obdrží oznámení o události. Ovládací prvek se vrátí, jakmile budou oznámeny všechny komponenty.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

(Zděděno od DkmModuleInstance)
OnBinaryReloadOpportunity()

Vyvolat BinaryReloadOpportunity událost. Součásti, které implementují rozhraní jímky událostí, obdrží oznámení o události. Ovládací prvek se vrátí, jakmile budou oznámeny všechny komponenty.

Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2).

(Zděděno od DkmModuleInstance)
OnModuleModified()

Tato metoda je volána, když se modul změní z důvodu EnC nebo dynamicky generovaného kódu.

Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

(Zděděno od DkmModuleInstance)
OnSymbolsLoaded(DkmModule, Boolean)

Tato metoda je vyvolána základní ladicí monitory v reakci na volání IDkmModuleSymbolsLoaded.RaiseSymbolsLoadedEvent. Tato metoda musí být vyvolána z vlákna události nebo z vlákna požadavku jako součást opětovného načtení. Monitorování základního ladění by se mělo synchronně přepnout na vlákno událostí, pozastavit cílový proces a vyvolat OnSymbolsLoaded.

Omezení umístění: Rozhraní API se musí volat z komponenty Monitor (úroveň < komponenty 100 000).

(Zděděno od DkmModuleInstance)
OnSymbolsUpdated(DkmModule)

Vyvolání události ModuleSymbolsUpdated Součásti, které implementují rozhraní jímky událostí, obdrží oznámení o události. Ovládací prvek se vrátí, jakmile budou oznámeny všechny komponenty.

(Zděděno od DkmModuleInstance)
ReadSymbols()

Tato metoda je vyvolána obslužnými rutinami symbolů pro čtení symbolů pro DkmModuleInstances, jejichž symboly se nacházejí v paměti ladicího modulu.

(Zděděno od DkmModuleInstance)
RemoveDataItem<T>()

Odeberte z tohoto kontejneru instanci T. Obvykle není nutné volat tuto metodu, protože kontejner dat se automaticky vyprázdní při zavření objektu.

(Zděděno od DkmDataContainer)
ResolveMappingMetadataTypeRefToken(Int32, String, Int32)

Řešení potíží s tokenem

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8).

ResolveTypeName(String, ReadOnlyCollection<DkmClrType>)

Přeloží název typu na typ. Pokud je typ obecný, nebudou se instance obecných parametrů vytvořit.

Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

(Zděděno od DkmClrModuleInstance)
SetDataItem<T>(DkmDataCreationDisposition, T)

Do kontejneru dat umístěte novou položku.

(Zděděno od DkmDataContainer)
SetDisabled(Boolean)

Aktualizace stav zakázaného modulu. Tato metoda může být volána pouze z ModuleInstanceLoad události. Při zakázání modulu je také běžné potlačit událost načtení modulu.

(Zděděno od DkmModuleInstance)
SetModule(DkmModule, Boolean)

Tato metoda je vyvolána zprostředkovatel symbolu pro přidružení DkmModule k DkmModuleInstance a k aktivaci ModuleSymbolsLoaded událost. Může být volána pouze jednou pro objekt DkmModuleInstance. Voláním tohoto rozhraní API vytvoříte přidružení DkmModule-DkmModuleInstance<> a také způsobí vyvolání události ModuleSymbolsLoaded.

(Zděděno od DkmModuleInstance)
TryLoadBinary()

Pokuste se načíst binární soubor, který se dříve nepodařilo načíst pomocí aktualizovaných cest symbolů.

(Zděděno od DkmModuleInstance)
TryLoadBinary(DkmWorkList, DkmCompletionRoutine<DkmTryLoadBinaryAsyncResult>)

Pokuste se načíst binární soubor, který se dříve nepodařilo načíst pomocí aktualizovaných cest symbolů.

Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.

(Zděděno od DkmModuleInstance)
TryLoadDecompiledSymbols()

Pokusy o načtení dekompilovaných symbolů modulu v mezipaměti.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

(Zděděno od DkmClrModuleInstance)
TryLoadDecompiledSymbols(DkmWorkList, DkmCompletionRoutine<DkmTryLoadDecompiledSymbolsAsyncResult>)

Pokusy o načtení dekompilovaných symbolů modulu v mezipaměti.

Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5).

(Zděděno od DkmClrModuleInstance)
TryLoadSymbols()

Volá se k zahájení načítání symbolů pro instance DkmModuleInstances, jejichž symboly nebyly nalezeny při načtení modulu.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

(Zděděno od DkmModuleInstance)
TryLoadSymbols(DkmSymbolLoadFlags)

Volá se k zahájení načítání symbolů pro instance DkmModuleInstances, jejichž symboly nebyly nalezeny při načtení modulu.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4).

(Zděděno od DkmModuleInstance)
TryLoadSymbols(DkmWorkList, DkmCompletionRoutine<DkmTryLoadSymbolsAsyncResult>)

Volá se k zahájení načítání symbolů pro instance DkmModuleInstances, jejichž symboly nebyly nalezeny při načtení modulu.

Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

(Zděděno od DkmModuleInstance)
TryLoadSymbols(DkmWorkList, DkmSymbolLoadFlags, DkmCompletionRoutine<DkmTryLoadSymbolsAsyncResult>)

Volá se k zahájení načítání symbolů pro instance DkmModuleInstances, jejichž symboly nebyly nalezeny při načtení modulu.

Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.

Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4).

(Zděděno od DkmModuleInstance)
TryLoadSymbolsCallback()

Volá se k zahájení načítání symbolů pro instance DkmModuleInstances, jejichž symboly nebyly nalezeny při načtení modulu.

Omezení umístění: Tuto možnost lze volat z klienta nebo serveru. Serverová implementace je mezipaměť, která zabraňuje zbytečným síťovým voláním. Klient přejde přímo do "skutečné" implementace, která také zajistí, že se reattempts vrátí brzy.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 RTM (DkmApiVersion.VS17RTM).

(Zděděno od DkmModuleInstance)
TryLoadSymbolsCallback(DkmWorkList, DkmCompletionRoutine<DkmTryLoadSymbolsCallbackAsyncResult>)

Volá se k zahájení načítání symbolů pro instance DkmModuleInstances, jejichž symboly nebyly nalezeny při načtení modulu.

Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.

Omezení umístění: Tuto možnost lze volat z klienta nebo serveru. Serverová implementace je mezipaměť, která zabraňuje zbytečným síťovým voláním. Klient přejde přímo do "skutečné" implementace, která také zajistí, že se reattempts vrátí brzy.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 RTM (DkmApiVersion.VS17RTM).

(Zděděno od DkmModuleInstance)
TryLoadSymbolsCallback177(DkmSymbolLoadFlags)

Volá se k zahájení načítání místně přítomných symbolů pro instance DkmModuleInstances, jejichž symboly nebyly nalezeny při načtení modulu.

Omezení umístění: Tuto možnost lze volat z klienta nebo serveru. Serverová implementace je mezipaměť, která zabraňuje zbytečným síťovým voláním. Klient přejde přímo do "skutečné" implementace, která také zajistí, že se reattempts vrátí brzy.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).

(Zděděno od DkmModuleInstance)
TryLoadSymbolsCallback177(DkmWorkList, DkmSymbolLoadFlags, DkmCompletionRoutine<DkmTryLoadSymbolsCallback177AsyncResult>)

Volá se k zahájení načítání místně přítomných symbolů pro instance DkmModuleInstances, jejichž symboly nebyly nalezeny při načtení modulu.

Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení.

Omezení umístění: Tuto možnost lze volat z klienta nebo serveru. Serverová implementace je mezipaměť, která zabraňuje zbytečným síťovým voláním. Klient přejde přímo do "skutečné" implementace, která také zajistí, že se reattempts vrátí brzy.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).

(Zděděno od DkmModuleInstance)
TryResolveToken(DkmStackWalkFrame, Int32, DkmClrType, Int32)

Pokusí se přeložit token z oboru tohoto modulu na definující modul.

Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8).

(Zděděno od DkmClrModuleInstance)
Unload()

Označte objekt Unload jako unloaded a upozorněte komponenty, které implementují rozhraní jímky událostí. Ovládací prvek se vrátí, jakmile budou všechny komponenty upozorněny.

Tuto metodu může volat pouze komponenta, která objekt vytvořila.

(Zděděno od DkmModuleInstance)

Platí pro