Share via


DkmProcess.Create Method

Definition

Overloads

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)

Creates a new process object. This method is called from the base debug monitor on the event thread as part of the processing of IDkmStartDebuggingOperations.AttachToProcess or IDkmStartDebuggingOperations.ResumeDebuggedProcess.

This method will send a ProcessCreate event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)

Creates a new process object. This method is called from the base debug monitor on the event thread as part of the processing of IDkmStartDebuggingOperations.AttachToProcess or IDkmStartDebuggingOperations.ResumeDebuggedProcess.

This method will send a ProcessCreate event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)

Creates a new process object. This method is called from the base debug monitor on the event thread as part of the processing of IDkmStartDebuggingOperations.AttachToProcess or IDkmStartDebuggingOperations.ResumeDebuggedProcess.

This method will send a ProcessCreate event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)

Creates a new process object. This method is called from the base debug monitor on the event thread as part of the processing of IDkmStartDebuggingOperations.AttachToProcess or IDkmStartDebuggingOperations.ResumeDebuggedProcess.

This method will send a ProcessCreate event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9).

public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsMultiArch, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * bool * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess
Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsAppPackage As Boolean, IsMultiArch As Boolean, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess

Parameters

Connection
DkmTransportConnection

[In] This represents a connection between the monitor and the IDE. It can either be a local connection if the monitor is running in the same process as the IDE, or it can be a remote connection. In the monitor process, there is only one connection.

Path
String

[In] Full path to the starting executable of the process.

UniqueId
Guid

[In] Guid which uniquely identifies this process object. This Guid value is the same as the Guid exposed at the SDM layer (IDebugProcess2::GetProcessId) and at the automation layer.

StartMethod
DkmStartMethod

[In] StartMethod describes how the debug engine started debugging this process.

EngineSettings
DkmEngineSettings

[In] Contains the session-wide debug settings. There is one instance of this object per engine Guid (ex: one instance for COMPlusOnlyEng2, one instance for COMPlusNativeEng).

DebugLaunchSettings
DkmDebugLaunchSettings

[In] Settings supplied during a start debugging operation from a project system or other caller of LaunchDebugTargets (or various other start debugging APIs).

SystemInformation
DkmSystemInformation

[In] Contains information about the computer system that this process is running under. If this process is running under WOW (32-bit emulation on a 64-bit OS) this information will be for the 32-bit subsystem rather than the 64-bit subsystem.

BaseDebugMonitorId
Guid

[In] DkmBaseDebugMonitorId identifies the base debug monitor used to inspect and control the debugged process. For example, DkmBaseDebugMonitorId.WindowsProcess is used for processes debugged by the Win32 debugging API and DkmBaseDebugMonitorId.DumpFile is used for minidumps.

IsAppPackage
Boolean

[In] True if the process belongs to a Windows Store app package or Windows Phone app package.

IsMultiArch
Boolean

[In] True if the process contains code from multiple architectures.

IsNativeDebuggingEnabled
Boolean

[In] When true, the debugger will attempt to debug native code - it will stop on native exceptions, load symbols, display native frames on the call stack, bind and hit breakpoints, and leave native threads stopped while in break state.

Live
DkmProcess.Live

[In,Optional] Information relevant to a running process. For example, this Part will NOT be present for minidumps.

DataItem
DkmDataItem

[In,Optional] Data object to add to the new DkmProcess instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

[Out] Result of this method call.

Applies to

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)

Creates a new process object. This method is called from the base debug monitor on the event thread as part of the processing of IDkmStartDebuggingOperations.AttachToProcess or IDkmStartDebuggingOperations.ResumeDebuggedProcess.

This method will send a ProcessCreate event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

public:
 static Microsoft::VisualStudio::Debugger::DkmProcess ^ Create(Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, System::String ^ Path, Guid UniqueId, Microsoft::VisualStudio::Debugger::Start::DkmStartMethod StartMethod, Microsoft::VisualStudio::Debugger::DkmEngineSettings ^ EngineSettings, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, Microsoft::VisualStudio::Debugger::DefaultPort::DkmSystemInformation ^ SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft::VisualStudio::Debugger::DkmProcess::Live ^ Live, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live Live, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess
Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsAppPackage As Boolean, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess

Parameters

Connection
DkmTransportConnection

[In] This represents a connection between the monitor and the IDE. It can either be a local connection if the monitor is running in the same process as the IDE, or it can be a remote connection. In the monitor process, there is only one connection.

Path
String

[In] Full path to the starting executable of the process.

UniqueId
Guid

[In] Guid which uniquely identifies this process object. This Guid value is the same as the Guid exposed at the SDM layer (IDebugProcess2::GetProcessId) and at the automation layer.

StartMethod
DkmStartMethod

[In] StartMethod describes how the debug engine started debugging this process.

EngineSettings
DkmEngineSettings

[In] Contains the session-wide debug settings. There is one instance of this object per engine Guid (ex: one instance for COMPlusOnlyEng2, one instance for COMPlusNativeEng).

DebugLaunchSettings
DkmDebugLaunchSettings

[In] Settings supplied during a start debugging operation from a project system or other caller of LaunchDebugTargets (or various other start debugging APIs).

SystemInformation
DkmSystemInformation

[In] Contains information about the computer system that this process is running under. If this process is running under WOW (32-bit emulation on a 64-bit OS) this information will be for the 32-bit subsystem rather than the 64-bit subsystem.

BaseDebugMonitorId
Guid

[In] DkmBaseDebugMonitorId identifies the base debug monitor used to inspect and control the debugged process. For example, DkmBaseDebugMonitorId.WindowsProcess is used for processes debugged by the Win32 debugging API and DkmBaseDebugMonitorId.DumpFile is used for minidumps.

IsAppPackage
Boolean

[In] True if the process belongs to a Windows Store app package or Windows Phone app package.

IsNativeDebuggingEnabled
Boolean

[In] When true, the debugger will attempt to debug native code - it will stop on native exceptions, load symbols, display native frames on the call stack, bind and hit breakpoints, and leave native threads stopped while in break state.

Live
DkmProcess.Live

[In,Optional] Information relevant to a running process. For example, this Part will NOT be present for minidumps.

DataItem
DkmDataItem

[In,Optional] Data object to add to the new DkmProcess instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

[Out] Result of this method call.

Applies to

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)

Creates a new process object. This method is called from the base debug monitor on the event thread as part of the processing of IDkmStartDebuggingOperations.AttachToProcess or IDkmStartDebuggingOperations.ResumeDebuggedProcess.

This method will send a ProcessCreate event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

public:
 static Microsoft::VisualStudio::Debugger::DkmProcess ^ Create(Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, System::String ^ Path, Guid UniqueId, Microsoft::VisualStudio::Debugger::Start::DkmStartMethod StartMethod, Microsoft::VisualStudio::Debugger::DkmEngineSettings ^ EngineSettings, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, Microsoft::VisualStudio::Debugger::DefaultPort::DkmSystemInformation ^ SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft::VisualStudio::Debugger::DkmProcess::Live ^ Live, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live Live, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcess Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess
Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess

Parameters

Connection
DkmTransportConnection

[In] This represents a connection between the monitor and the IDE. It can either be a local connection if the monitor is running in the same process as the IDE, or it can be a remote connection. In the monitor process, there is only one connection.

Path
String

[In] Full path to the starting executable of the process.

UniqueId
Guid

[In] Guid which uniquely identifies this process object. This Guid value is the same as the Guid exposed at the SDM layer (IDebugProcess2::GetProcessId) and at the automation layer.

StartMethod
DkmStartMethod

[In] StartMethod describes how the debug engine started debugging this process.

EngineSettings
DkmEngineSettings

[In] Contains the session-wide debug settings. There is one instance of this object per engine Guid (ex: one instance for COMPlusOnlyEng2, one instance for COMPlusNativeEng).

DebugLaunchSettings
DkmDebugLaunchSettings

[In] Settings supplied during a start debugging operation from a project system or other caller of LaunchDebugTargets (or various other start debugging APIs).

SystemInformation
DkmSystemInformation

[In] Contains information about the computer system that this process is running under. If this process is running under WOW (32-bit emulation on a 64-bit OS) this information will be for the 32-bit subsystem rather than the 64-bit subsystem.

BaseDebugMonitorId
Guid

[In] DkmBaseDebugMonitorId identifies the base debug monitor used to inspect and control the debugged process. For example, DkmBaseDebugMonitorId.WindowsProcess is used for processes debugged by the Win32 debugging API and DkmBaseDebugMonitorId.DumpFile is used for minidumps.

IsNativeDebuggingEnabled
Boolean

[In] When true, the debugger will attempt to debug native code - it will stop on native exceptions, load symbols, display native frames on the call stack, bind and hit breakpoints, and leave native threads stopped while in break state.

Live
DkmProcess.Live

[In,Optional] Information relevant to a running process. For example, this Part will NOT be present for minidumps.

DataItem
DkmDataItem

[In,Optional] Data object to add to the new DkmProcess instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

[Out] Result of this method call.

Applies to