DkmDebugProcessRequest Class

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Start

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Object used to send a request to the IDE to request that Visual Studio should debug an additional process. This may be used, for example, to debug a child process.

This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

public ref class DkmDebugProcessRequest

[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmDebugProcessRequest

[Windows::Foundation::Metadata::WebHostHidden]
class DkmDebugProcessRequest

[System.Runtime.InteropServices.Guid("847301d5-269c-7461-c18d-90df9175fe08")]
public class DkmDebugProcessRequest

[<System.Runtime.InteropServices.Guid("847301d5-269c-7461-c18d-90df9175fe08")>]
type DkmDebugProcessRequest = class

Public Class DkmDebugProcessRequest

Inheritance

Object

DkmDebugProcessRequest

Attributes

GuidAttribute

Properties

EngineFilter	[Optional] Guids for the set of debug engines to be used to debug this process. If null, debugger will determine the correct engine filter based on any child process debugging settings. Currently, this will simply use the engine from the parent process, but this is subject to change in the future. To force the same engine to be used, the caller should pass LogicalParentProcess.DebugLaunchSettings.EngineFilter rather than null. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Flags	Flags passed in the DkmDebugProcessRequest object. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
LogicalParentProcess	The process which is logically the parent of the new process which is going to be debugged. For something like child process debugging, this should generally be the actual parent process. In other cases, it could simply be the process which is performing, an action which motivates the request to debug. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Path	Full path to the starting executable of the process. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ProcessId	Process which the debugger should attach to. In general, this should be a new process which is still at the initial suspension point. However, in some cases such as when a base dm is already attached to the process, and sends the request merely to get the rest of the debugger ready to debug the process, this restriction may not apply. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
StartTime	64-bit date time value indicating when the process was started. The start time along with the id and the machine where the process was started can uniquely identify a process. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

Methods

Create(Int32, Int64, DkmProcess, String, ReadOnlyCollection<Guid>, DkmDebugProcessRequestFlags)

Create a new DkmDebugProcessRequest object instance. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

Send(DkmWorkList, DkmCompletionRoutine<DkmDebugProcessRequestAsyncResult>)

Sends the debug request to the IDE. The completion routine will be notified when the attach completes. This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).