DkmDebugProcessRequest.Create(Int32, Int64, DkmProcess, String, ReadOnlyCollection<Guid>, DkmDebugProcessRequestFlags) Метод

Определение

Создайте новый экземпляр объекта Дкмдебугпроцессрекуест.Create a new DkmDebugProcessRequest object instance.

Этот API появился в Visual Studio 14 RTM (Дкмапиверсион. VS14RTM).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);
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

Параметры

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-разрядное значение даты и времени, указывающее время запуска процесса.[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>

[Входные, необязательные] Идентификаторы GUID для набора отладочных модулей, которые будут использоваться для отладки этого процесса.[In,Optional] Guids for the set of debug engines to be used to debug this process. Если значение равно null, отладчик определит правильный фильтр подсистемы на основе любых параметров отладки дочернего процесса.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. Чтобы принудительно использовать ту же подсистему, вызывающий объект должен передать Логикалпарентпроцесс. Дебуглаунчсеттингс. Енгинефилтер, а не NULL.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.

Возвращаемое значение

DkmDebugProcessRequest

Заполняет Результат вызова этого метода.[Out] Result of this method call.

Применяется к