IDkmStartDebuggingOperations Interface

Definition

This interface contains the API for launching a new process under the debugger or attaching the debugger to an existing process.

Implementations of this interface may restrict when they are called using a filter defined in their component configuration. The following properties may be used: BaseDebugMonitorId, EngineId, TransportKind.

public interface class IDkmStartDebuggingOperations
public interface class IDkmStartDebuggingOperations
__interface IDkmStartDebuggingOperations
public interface IDkmStartDebuggingOperations
type IDkmStartDebuggingOperations = interface
Public Interface IDkmStartDebuggingOperations

Methods

AttachToProcess(DkmProcessAttachRequest)

Causes the debug monitor to attach to the process. Before this method returns, the debug monitor must start an event thread (or reuse an existing event thread) and create the DkmProcess object on the event thread. Creating the DkmProcess object will send a process create event.

Note that this method may only be called in response to the Visual Studio debugger package requesting an attach. Components that wish to attach to another process should send a custom event to a visual studio package. From a package, an attach can be requested through the IVsDebugger.LaunchDebugTargets API.

LaunchDebuggedProcess(DkmProcessLaunchRequest)

Causes the debug monitor to create a new process under the debugger. The process should be left suspended until ResumeDebuggedProcess is called. The debug monitor must wait for ResumeDebuggedProcess before creating the DkmProcess object since it needs the UniqueProcessId value from the AD7 Layer.

Note that this method may only be called in response to the Visual Studio debugger package requesting a launch. Components that wish to launch another process under the debugger should send a custom event to a visual studio package. From a package, a launch can be requested through the IVsDebugger.LaunchDebugTargets API.

ResumeDebuggedProcess(DkmProcessLaunchRequest, Guid)

Causes the debug monitor to resume a launched process and create the DkmProcess object. The DkmProcess object will be created on the event thread and creating the object will send a process create event.

Note that this method may only be called in response to the Visual Studio debugger package requesting a launch. Components that wish to launch another process under the debugger should send a custom event to a visual studio package. From a package, a launch can be requested through the IVsDebugger.LaunchDebugTargets API.

Applies to