DkmCustomRuntimeInstance.Create Methode

Definition

Überlädt

Create(DkmProcess, DkmRuntimeInstanceId, DkmDataItem)

Erstellt ein neues Lauf Zeit Instanzobjekt aus einem Debugmonitor.Creates a new runtime instance object from a debug monitor. Diese Methode muss vom Ereignis Thread aufgerufen werden, wenn ein Debugmonitor erkennt, dass eine neue Lauf Zeit Instanz geladen wurde (z. b. wenn die entsprechende Lauf Zeit-dll in den Ziel Prozess geladen wird).This method must be called from the event thread when a debug monitor detects that a new runtime instance has loaded (for example, when the corresponding runtime dll loads in the target process).

Diese Methode sendet ein runtimeinstanceload-Ereignis.This method will send a RuntimeInstanceLoad event.

Location-Einschränkung: die API muss von einer Monitor Komponente (Komponentenebene < 100.000) aufgerufen werden.Location constraint: API must be called from a Monitor component (component level < 100,000).

Create(DkmProcess, DkmRuntimeInstanceId, DkmRuntimeCapabilities, DkmRuntimeInstance, DkmDataItem)

Erstellt ein neues Lauf Zeit Instanzobjekt aus einem Debugmonitor.Creates a new runtime instance object from a debug monitor. Diese Methode muss vom Ereignis Thread aufgerufen werden, wenn ein Debugmonitor erkennt, dass eine neue Lauf Zeit Instanz geladen wurde (z. b. wenn die entsprechende Lauf Zeit-dll in den Ziel Prozess geladen wird).This method must be called from the event thread when a debug monitor detects that a new runtime instance has loaded (for example, when the corresponding runtime dll loads in the target process).

Diese Methode sendet ein runtimeinstanceload-Ereignis.This method will send a RuntimeInstanceLoad event.

Location-Einschränkung: die API muss von einer Monitor Komponente (Komponentenebene < 100.000) aufgerufen werden.Location constraint: API must be called from a Monitor component (component level < 100,000).

Diese API wurde in Visual Studio 12 RTM (dkmapiversion. VS12RTM) eingeführt.This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Create(DkmProcess, DkmRuntimeInstanceId, DkmDataItem)

Erstellt ein neues Lauf Zeit Instanzobjekt aus einem Debugmonitor.Creates a new runtime instance object from a debug monitor. Diese Methode muss vom Ereignis Thread aufgerufen werden, wenn ein Debugmonitor erkennt, dass eine neue Lauf Zeit Instanz geladen wurde (z. b. wenn die entsprechende Lauf Zeit-dll in den Ziel Prozess geladen wird).This method must be called from the event thread when a debug monitor detects that a new runtime instance has loaded (for example, when the corresponding runtime dll loads in the target process).

Diese Methode sendet ein runtimeinstanceload-Ereignis.This method will send a RuntimeInstanceLoad event.

Location-Einschränkung: die API muss von einer Monitor Komponente (Komponentenebene < 100.000) aufgerufen werden.Location constraint: API must be called from a Monitor component (component level < 100,000).

public:
 static Microsoft::VisualStudio::Debugger::CustomRuntimes::DkmCustomRuntimeInstance ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, Microsoft::VisualStudio::Debugger::DkmRuntimeInstanceId Id, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomRuntimeInstance Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId Id, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomRuntimeInstance
Public Shared Function Create (Process As DkmProcess, Id As DkmRuntimeInstanceId, DataItem As DkmDataItem) As DkmCustomRuntimeInstance

Parameter

Process
DkmProcess

In Dkmprocess stellt einen Ziel Prozess dar, der debuggt wird.[In] DkmProcess represents a target process which is being debugged. Der Debugger debuggt die Prozesse, sodass dies die grundlegende debugeinheit ist.The debugger debugs processes, so this is the basic unit of debugging. Ein dkmprocess kann einen System Prozess oder einen virtuellen Prozess, z. b. Minidumps, darstellen.A DkmProcess can represent a system process or a virtual process such as minidumps.

Id
DkmRuntimeInstanceId

In Identifiziert ein dkmruntimeinstance-Objekt in einem Prozess.[In] Identifies a DkmRuntimeInstance object within a process.

DataItem
DkmDataItem

[In, optional] Das Datenobjekt, das der neuen dkmcustomruntimeinstance-Instanz hinzugefügt werden soll.[In,Optional] Data object to add to the new DkmCustomRuntimeInstance instance. Übergeben Sie "Null", wenn der Aufrufer kein Datenelement hinzufügen muss.Pass 'null' in the case that the caller doesn't need to add a data item.

Gibt zurück

DkmCustomRuntimeInstance

Vorgenommen Ergebnis dieses Methoden Aufrufes.[Out] Result of this method call.

Gilt für:

Create(DkmProcess, DkmRuntimeInstanceId, DkmRuntimeCapabilities, DkmRuntimeInstance, DkmDataItem)

Erstellt ein neues Lauf Zeit Instanzobjekt aus einem Debugmonitor.Creates a new runtime instance object from a debug monitor. Diese Methode muss vom Ereignis Thread aufgerufen werden, wenn ein Debugmonitor erkennt, dass eine neue Lauf Zeit Instanz geladen wurde (z. b. wenn die entsprechende Lauf Zeit-dll in den Ziel Prozess geladen wird).This method must be called from the event thread when a debug monitor detects that a new runtime instance has loaded (for example, when the corresponding runtime dll loads in the target process).

Diese Methode sendet ein runtimeinstanceload-Ereignis.This method will send a RuntimeInstanceLoad event.

Location-Einschränkung: die API muss von einer Monitor Komponente (Komponentenebene < 100.000) aufgerufen werden.Location constraint: API must be called from a Monitor component (component level < 100,000).

Diese API wurde in Visual Studio 12 RTM (dkmapiversion. VS12RTM) eingeführt.This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

public:
 static Microsoft::VisualStudio::Debugger::CustomRuntimes::DkmCustomRuntimeInstance ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, Microsoft::VisualStudio::Debugger::DkmRuntimeInstanceId Id, Microsoft::VisualStudio::Debugger::DkmRuntimeCapabilities Capabilities, Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ ParentRuntime, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomRuntimeInstance Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId Id, Microsoft.VisualStudio.Debugger.DkmRuntimeCapabilities Capabilities, Microsoft.VisualStudio.Debugger.DkmRuntimeInstance ParentRuntime, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId * Microsoft.VisualStudio.Debugger.DkmRuntimeCapabilities * Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.CustomRuntimes.DkmCustomRuntimeInstance
Public Shared Function Create (Process As DkmProcess, Id As DkmRuntimeInstanceId, Capabilities As DkmRuntimeCapabilities, ParentRuntime As DkmRuntimeInstance, DataItem As DkmDataItem) As DkmCustomRuntimeInstance

Parameter

Process
DkmProcess

In Dkmprocess stellt einen Ziel Prozess dar, der debuggt wird.[In] DkmProcess represents a target process which is being debugged. Der Debugger debuggt die Prozesse, sodass dies die grundlegende debugeinheit ist.The debugger debugs processes, so this is the basic unit of debugging. Ein dkmprocess kann einen System Prozess oder einen virtuellen Prozess, z. b. Minidumps, darstellen.A DkmProcess can represent a system process or a virtual process such as minidumps.

Id
DkmRuntimeInstanceId

In Identifiziert ein dkmruntimeinstance-Objekt in einem Prozess.[In] Identifies a DkmRuntimeInstance object within a process.

Capabilities
DkmRuntimeCapabilities

In Enumeration der Lauf Zeitfunktionen.[In] Enumeration of runtime capabilities.

ParentRuntime
DkmRuntimeInstance

[In, optional] Bei Laufzeiten, die auf einer anderen Laufzeit implementiert werden, kann dies optional verwendet werden, um das logische übergeordnete Element nicht zu unterscheiden.[In,Optional] For runtimes that are implemented on top of another runtime, this can optionally be used to indicant the logical parent. Diese kann dann verwendet werden, um Dienste vom übergeordneten Element anzufordern, wenn die untergeordnete Laufzeit den Dienst nicht implementiert.This can then be used to request services from the parent when the child runtime doesn't implement the service. Dies wird derzeit nur zum Abrufen des obersten Stapel Rahmens zum Auswerten eines bedingten halte Punkts verwendet, wenn die untergeordnete Laufzeit keine Stapel selbst durchläuft.This is currently used only for obtaining the top stack frame to evaluate a conditional breakpoint when the child runtime doesn't walk stacks itself.

DataItem
DkmDataItem

[In, optional] Das Datenobjekt, das der neuen dkmcustomruntimeinstance-Instanz hinzugefügt werden soll.[In,Optional] Data object to add to the new DkmCustomRuntimeInstance instance. Übergeben Sie "Null", wenn der Aufrufer kein Datenelement hinzufügen muss.Pass 'null' in the case that the caller doesn't need to add a data item.

Gibt zurück

DkmCustomRuntimeInstance

Vorgenommen Ergebnis dieses Methoden Aufrufes.[Out] Result of this method call.

Gilt für: