DkmClrNcRuntimeInstance.Create 方法

定义

从调试监视器创建新的运行时实例对象。 当调试监视器检测到新的运行时实例已加载 (例如,在目标进程中加载相应的运行时 dll 时,必须从事件线程调用此方法) 。

此方法将发送 RuntimeInstanceLoad 事件。

位置约束:必须从监视器组件 (组件级别 100000) 中调用 API < 。

此 API 是在 Visual Studio 15 Update 6 (VS15Update6) 中引入的。

public:
 static Microsoft::VisualStudio::Debugger::Clr::NativeCompilation::DkmClrNcRuntimeInstance ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, Microsoft::VisualStudio::Debugger::DkmRuntimeInstanceId Id, Microsoft::VisualStudio::Debugger::DkmRuntimeCapabilities Capabilities, Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ ParentRuntime, System::String ^ RuntimeVersion, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Clr.NativeCompilation.DkmClrNcRuntimeInstance Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId Id, Microsoft.VisualStudio.Debugger.DkmRuntimeCapabilities Capabilities, Microsoft.VisualStudio.Debugger.DkmRuntimeInstance ParentRuntime, string RuntimeVersion, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId * Microsoft.VisualStudio.Debugger.DkmRuntimeCapabilities * Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * string * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Clr.NativeCompilation.DkmClrNcRuntimeInstance
Public Shared Function Create (Process As DkmProcess, Id As DkmRuntimeInstanceId, Capabilities As DkmRuntimeCapabilities, ParentRuntime As DkmRuntimeInstance, RuntimeVersion As String, DataItem As DkmDataItem) As DkmClrNcRuntimeInstance

参数

Process
DkmProcess

中DkmProcess 表示正在调试的目标进程。 调试器调试进程,因此这是调试的基本单元。 DkmProcess 可以表示系统进程或虚拟进程,如小型转储。

Id
DkmRuntimeInstanceId

中标识进程中的 DkmRuntimeInstance 对象。

Capabilities
DkmRuntimeCapabilities

中运行时功能的枚举。

ParentRuntime
DkmRuntimeInstance

[In,可选]对于在另一个运行时之上实现的运行时,可以选择使用它来 indicant 逻辑父级。 如果子运行时未实现服务,则可以使用此项从父运行时请求服务。 此值当前仅用于获取顶部堆栈帧,以便在子运行时不遍历自身时计算条件断点。

RuntimeVersion
String

[In,可选]CLR 实例的版本字符串 (例如: "2.0.50727" ) 。

DataItem
DkmDataItem

[In,可选]要添加到新的 DkmClrNcRuntimeInstance 实例的数据对象。 如果调用方不需要添加数据项,则传递 "null"。

返回

DkmClrNcRuntimeInstance

弄此方法调用的结果。

适用于