DkmProcess.Create メソッド

リファレンス

定義

名前空間:: Microsoft.VisualStudio.Debugger

アセンブリ:: Microsoft.VisualStudio.Debugger.Engine.dll

パッケージ:: Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

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

新しいプロセスオブジェクトを作成します。このメソッドは、IDkmStartDebuggingOperations.AttachToProcess または IDkmStartDebuggingOperations.ResumeDebuggedProcess の処理の一環として、イベントスレッドの基本デバッグモニターから呼び出されます。

このメソッドは ProcessCreate イベントを送信します。

場所の制約: API は Monitor コンポーネント (コンポーネントレベル < 100,000) から呼び出す必要があります。

この API は、Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9) で導入されました。

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

このメソッドは ProcessCreate イベントを送信します。

場所の制約: API は Monitor コンポーネント (コンポーネントレベル < 100,000) から呼び出す必要があります。

この API は Visual Studio 12 RTM (DkmApiVersion.VS12RTM) で導入されました。

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

このメソッドは ProcessCreate イベントを送信します。

場所の制約: API は Monitor コンポーネント (コンポーネントレベル < 100,000) から呼び出す必要があります。

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

このメソッドは ProcessCreate イベントを送信します。

場所の制約: API は Monitor コンポーネント (コンポーネントレベル < 100,000) から呼び出す必要があります。

この API は、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

パラメーター

Connection: DkmTransportConnection

[入力]これは、モニターと IDE の間の接続を表します。モニターが IDE と同じプロセスで実行されている場合はローカル接続にすることも、リモート接続にすることもできます。モニタープロセスでは、接続は 1 つだけです。

Path: String

[入力]プロセスの開始実行可能ファイルへの完全パス。

UniqueId: Guid

[入力]このプロセスオブジェクトを一意に識別する Guid。この Guid 値は、SDM レイヤー (IDebugProcess2::GetProcessId) とオートメーションレイヤーで公開される Guid と同じです。

StartMethod: DkmStartMethod

[入力]StartMethod では、デバッグエンジンがこのプロセスのデバッグを開始した方法について説明します。

EngineSettings: DkmEngineSettings

[入力]セッション全体のデバッグ設定が含まれます。このオブジェクトのインスタンスは、エンジン Guid ごとに 1 つあります (たとえば、COMPlusOnlyEng2 のインスタンスは 1 つ、COMPlusNativeEng の場合は 1 つのインスタンス)。

DebugLaunchSettings: DkmDebugLaunchSettings

[入力]プロジェクトシステムまたは LaunchDebugTargets の他の呼び出し元 (または他のさまざまなデバッグ開始 API) からのデバッグ開始操作中に指定された設定。

SystemInformation: DkmSystemInformation

[入力]このプロセスが実行されているコンピューターシステムに関する情報が含まれます。このプロセスが WOW (64 ビット OS 上の 32 ビットエミュレーション) で実行されている場合、この情報は 64 ビットサブシステムではなく 32 ビットサブシステム用になります。

BaseDebugMonitorId: Guid

[入力]DkmBaseDebugMonitorId は、デバッグされたプロセスの検査と制御に使用される基本デバッグモニターを識別します。たとえば、DkmBaseDebugMonitorId.WindowsProcess は Win32 デバッグ API によってデバッグされるプロセスに使用され、DkmBaseDebugMonitorId.DumpFile はミニダンプに使用されます。

IsAppPackage: Boolean

[入力]プロセスが Windows ストアアプリパッケージまたはアプリパッケージに属している場合Windows Phone True。

IsMultiArch: Boolean

[入力]True を指定すると、プロセスに複数のアーキテクチャのコードが含まれます。

IsNativeDebuggingEnabled: Boolean

[入力]true の場合、デバッガーはネイティブコードのデバッグを試みます。ネイティブ例外で停止し、シンボルを読み込み、呼び出し履歴にネイティブフレームを表示し、ブレークポイントをバインドしてヒットし、中断状態の間はネイティブスレッドを停止したままにします。

Live: DkmProcess.Live

[入力,省略可能]実行中のプロセスに関連する情報。たとえば、このパーツはミニダンプには存在しません。

DataItem: DkmDataItem

[入力,省略可能]新しい DkmProcess インスタンスに追加するデータオブジェクト。呼び出し元がデータ項目を追加する必要がない場合は、'null' を渡します。

戻り値

DkmProcess

[出力]このメソッド呼び出しの結果。

適用対象

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

このメソッドは ProcessCreate イベントを送信します。

場所の制約: API は Monitor コンポーネント (コンポーネントレベル < 100,000) から呼び出す必要があります。

この API は 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

パラメーター

Connection: DkmTransportConnection

Path: String

[入力]プロセスの開始実行可能ファイルへの完全パス。

UniqueId: Guid

StartMethod: DkmStartMethod

[入力]StartMethod では、デバッグエンジンがこのプロセスのデバッグを開始した方法について説明します。

EngineSettings: DkmEngineSettings

DebugLaunchSettings: DkmDebugLaunchSettings

SystemInformation: DkmSystemInformation

BaseDebugMonitorId: Guid

IsAppPackage: Boolean

[入力]プロセスが Windows ストアアプリパッケージまたはアプリパッケージに属している場合Windows Phone True。

IsNativeDebuggingEnabled: Boolean

Live: DkmProcess.Live

[入力,省略可能]実行中のプロセスに関連する情報。たとえば、このパーツはミニダンプには存在しません。

DataItem: DkmDataItem

戻り値

DkmProcess

[出力]このメソッド呼び出しの結果。

適用対象

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

このメソッドは ProcessCreate イベントを送信します。

場所の制約: API は、Monitor コンポーネント (コンポーネントレベル < 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