DkmDebugProcessRequest.Create Method

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.Start
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Package:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Create a new DkmDebugProcessRequest object instance.

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

public:
 static Microsoft::VisualStudio::Debugger::Start::DkmDebugProcessRequest ^ Create(int ProcessId, long StartTime, Microsoft::VisualStudio::Debugger::DkmProcess ^ LogicalParentProcess, System::String ^ Path, System::Collections::ObjectModel::ReadOnlyCollection<Guid> ^ EngineFilter, Microsoft::VisualStudio::Debugger::Start::DkmDebugProcessRequestFlags Flags);
public static Microsoft.VisualStudio.Debugger.Start.DkmDebugProcessRequest Create (int ProcessId, long StartTime, Microsoft.VisualStudio.Debugger.DkmProcess LogicalParentProcess, string Path, System.Collections.ObjectModel.ReadOnlyCollection<Guid> EngineFilter, Microsoft.VisualStudio.Debugger.Start.DkmDebugProcessRequestFlags Flags);
public static Microsoft.VisualStudio.Debugger.Start.DkmDebugProcessRequest Create (int ProcessId, long StartTime, Microsoft.VisualStudio.Debugger.DkmProcess LogicalParentProcess, string Path, System.Collections.ObjectModel.ReadOnlyCollection<Guid>? EngineFilter, Microsoft.VisualStudio.Debugger.Start.DkmDebugProcessRequestFlags Flags);
static member Create : int * int64 * Microsoft.VisualStudio.Debugger.DkmProcess * string * System.Collections.ObjectModel.ReadOnlyCollection<Guid> * Microsoft.VisualStudio.Debugger.Start.DkmDebugProcessRequestFlags -> Microsoft.VisualStudio.Debugger.Start.DkmDebugProcessRequest
Public Shared Function Create (ProcessId As Integer, StartTime As Long, LogicalParentProcess As DkmProcess, Path As String, EngineFilter As ReadOnlyCollection(Of Guid), Flags As DkmDebugProcessRequestFlags) As DkmDebugProcessRequest

Parameters

ProcessId
Int32

[In] 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.

StartTime
Int64

[In] 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.

LogicalParentProcess
DkmProcess

[In] 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.

Path
String

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

EngineFilter
ReadOnlyCollection<Guid>

[In,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.

Flags
DkmDebugProcessRequestFlags

[In] Flags passed in the DkmDebugProcessRequest object.

Returns

DkmDebugProcessRequest

[Out] Result of this method call.

Applies to