DkmCustomRuntimeInstance.Create Метод

Определение

Перегрузки

Create(DkmProcess, DkmRuntimeInstanceId, DkmDataItem)

Создает новый объект экземпляра среды выполнения из монитора отладки.Creates a new runtime instance object from a debug monitor. Этот метод должен вызываться из потока событий, когда монитор отладки обнаруживает, что новый экземпляр среды выполнения загружен (например, когда соответствующая DLL-библиотека среды выполнения загружается в целевой процесс).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).

Этот метод будет отсылать событие Рунтимеинстанцелоад.This method will send a RuntimeInstanceLoad event.

Ограничение расположения: API должен вызываться из компонента монитора (уровень компонентов < 100 000).Location constraint: API must be called from a Monitor component (component level < 100,000).

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

Создает новый объект экземпляра среды выполнения из монитора отладки.Creates a new runtime instance object from a debug monitor. Этот метод должен вызываться из потока событий, когда монитор отладки обнаруживает, что новый экземпляр среды выполнения загружен (например, когда соответствующая DLL-библиотека среды выполнения загружается в целевой процесс).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).

Этот метод будет отсылать событие Рунтимеинстанцелоад.This method will send a RuntimeInstanceLoad event.

Ограничение расположения: API должен вызываться из компонента монитора (уровень компонентов < 100 000).Location constraint: API must be called from a Monitor component (component level < 100,000).

Этот API появился в Visual Studio 12 RTM (Дкмапиверсион. VS12RTM).This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Create(DkmProcess, DkmRuntimeInstanceId, DkmDataItem)

Создает новый объект экземпляра среды выполнения из монитора отладки.Creates a new runtime instance object from a debug monitor. Этот метод должен вызываться из потока событий, когда монитор отладки обнаруживает, что новый экземпляр среды выполнения загружен (например, когда соответствующая DLL-библиотека среды выполнения загружается в целевой процесс).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).

Этот метод будет отсылать событие Рунтимеинстанцелоад.This method will send a RuntimeInstanceLoad event.

Ограничение расположения: API должен вызываться из компонента монитора (уровень компонентов < 100 000).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

Параметры

Process
DkmProcess

Окне Дкмпроцесс представляет целевой процесс, который отлаживается.[In] DkmProcess represents a target process which is being debugged. Отладчик выполняет обработку ошибок, поэтому это основная единица отладки.The debugger debugs processes, so this is the basic unit of debugging. Дкмпроцесс может представлять системный процесс или виртуальный процесс, например Мини-дампы.A DkmProcess can represent a system process or a virtual process such as minidumps.

Id
DkmRuntimeInstanceId

Окне Определяет объект Дкмрунтимеинстанце внутри процесса.[In] Identifies a DkmRuntimeInstance object within a process.

DataItem
DkmDataItem

[Входные, необязательные] Объект данных, добавляемый в новый экземпляр Дкмкустомрунтимеинстанце.[In,Optional] Data object to add to the new DkmCustomRuntimeInstance instance. Передайте значение NULL в случае, если вызывающему объекту не нужно добавлять элемент данных.Pass 'null' in the case that the caller doesn't need to add a data item.

Возвращаемое значение

DkmCustomRuntimeInstance

Заполняет Результат вызова этого метода.[Out] Result of this method call.

Применяется к

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

Создает новый объект экземпляра среды выполнения из монитора отладки.Creates a new runtime instance object from a debug monitor. Этот метод должен вызываться из потока событий, когда монитор отладки обнаруживает, что новый экземпляр среды выполнения загружен (например, когда соответствующая DLL-библиотека среды выполнения загружается в целевой процесс).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).

Этот метод будет отсылать событие Рунтимеинстанцелоад.This method will send a RuntimeInstanceLoad event.

Ограничение расположения: API должен вызываться из компонента монитора (уровень компонентов < 100 000).Location constraint: API must be called from a Monitor component (component level < 100,000).

Этот API появился в Visual Studio 12 RTM (Дкмапиверсион. VS12RTM).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

Параметры

Process
DkmProcess

Окне Дкмпроцесс представляет целевой процесс, который отлаживается.[In] DkmProcess represents a target process which is being debugged. Отладчик выполняет обработку ошибок, поэтому это основная единица отладки.The debugger debugs processes, so this is the basic unit of debugging. Дкмпроцесс может представлять системный процесс или виртуальный процесс, например Мини-дампы.A DkmProcess can represent a system process or a virtual process such as minidumps.

Id
DkmRuntimeInstanceId

Окне Определяет объект Дкмрунтимеинстанце внутри процесса.[In] Identifies a DkmRuntimeInstance object within a process.

Capabilities
DkmRuntimeCapabilities

Окне Перечисление возможностей среды выполнения.[In] Enumeration of runtime capabilities.

ParentRuntime
DkmRuntimeInstance

[Входные, необязательные] Для сред выполнения, реализованных поверх другой среды выполнения, при необходимости можно использовать для индикант логического родителя.[In,Optional] For runtimes that are implemented on top of another runtime, this can optionally be used to indicant the logical parent. Затем он может использоваться для запроса служб от родительского объекта, когда дочерняя среда выполнения не реализует службу.This can then be used to request services from the parent when the child runtime doesn't implement the service. В настоящее время этот параметр используется только для получения верхнего кадра стека, чтобы оценить условную точку останова, когда дочерняя среда выполнения не просматривает саму себя в стеке.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] Data object to add to the new DkmCustomRuntimeInstance instance. Передайте значение NULL в случае, если вызывающему объекту не нужно добавлять элемент данных.Pass 'null' in the case that the caller doesn't need to add a data item.

Возвращаемое значение

DkmCustomRuntimeInstance

Заполняет Результат вызова этого метода.[Out] Result of this method call.

Применяется к