DkmPendingAddressNameBreakpoint クラス

定義

名前空間:

Microsoft.VisualStudio.Debugger.Breakpoints

アセンブリ:

Microsoft.VisualStudio.Debugger.Engine.dll

パッケージ:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

特定の命令アドレス文字列でコード要素にバインドするように要求される保留中のブレークポイント。 IDE 内では、ユーザーが呼び出し履歴または逆アセンブリ ウィンドウにブレークポイントを設定した後、デバッガーが別のデバッグ セッションまたは同じデバッグ セッション内の別のプロセスでブレークポイントを再バインドするように求められたときに、これらのブレークポイントが作成されます。

public ref class DkmPendingAddressNameBreakpoint : Microsoft::VisualStudio::Debugger::Breakpoints::DkmPendingBreakpoint

[System.Runtime.InteropServices.Guid("243712b0-a935-6c92-7fc4-6ffb461126ac")]
public class DkmPendingAddressNameBreakpoint : Microsoft.VisualStudio.Debugger.Breakpoints.DkmPendingBreakpoint

[<System.Runtime.InteropServices.Guid("243712b0-a935-6c92-7fc4-6ffb461126ac")>]
type DkmPendingAddressNameBreakpoint = class
    inherit DkmPendingBreakpoint

Public Class DkmPendingAddressNameBreakpoint
Inherits DkmPendingBreakpoint

継承

Object

DkmDataContainer

DkmPendingBreakpoint

DkmPendingAddressNameBreakpoint

属性

GuidAttribute

プロパティ

AddressName	バインド先のアドレスの文字列形式。
CompilerId	ブレークポイントをバインドする必要があるソース言語 (C#など) とコンパイラ ベンダー (Microsoft など) を識別します。 ブレークポイントがすべての言語にバインドされることを示すために、'LanguageId' を Guid.Empty のままにすることができます。 'VendorId' は、ほぼ常に Guid.Empty のままです。これは、言語のみが (コンパイラではなく) 既知であることを示します。 (継承元 DkmPendingBreakpoint)
FunctionName	[省略可能]アドレスを含む関数の名前。
IsBarrier	このブレークポイントがハードウェアで設定する必要があるバリアであるかどうかを示します。これは GPU デバッグに適しています。 (継承元 DkmPendingBreakpoint)
IsUnloaded	このオブジェクトに対して 'unloaded' イベントが発生した場合 (例: DkmThread::Unload が呼び出されます)、またはオブジェクトが閉じている場合は true を返します。 この状態を同期せずに確認する場合は、読み取った後に返される状態が正確でなくなる可能性があるため、注意が必要です。 (継承元 DkmDataContainer)
ModuleName	ブレークポイントを検索するモジュールの名前。
Process	DkmProcess は、デバッグ中のターゲット プロセスを表します。 デバッガーはプロセスをデバッグするため、これはデバッグの基本的な単位です。 DkmProcess は、システム プロセスまたはミニダンプなどの仮想プロセスを表すことができます。 (継承元 DkmPendingBreakpoint)
SourceId	オブジェクトのソースを識別します。 SourceIds は、複数のコンポーネントがクラスのインスタンスを作成している可能性があるシナリオでフィルター処理を有効にするために使用されます。 たとえば、ソース ID を使用して、別のコンポーネントによって作成されるブレークポイント (ステップ実行に使用される内部ブレークポイントなど) ではなく、AD7 AL (ユーザー ブレークポイント、SDM レベルで表示されるその他のブレークポイントなど) からブレークポイントが取得されているかどうかを判断できます。 (継承元 DkmPendingBreakpoint)
TagValue	DkmPendingBreakpoint は抽象基本クラスです。 この列挙型は、このオブジェクトがどの派生クラスのインスタンスであるかを示します。 (継承元 DkmPendingBreakpoint)
Thread	[省略可能]このブレークポイントを起動するスレッド。 null の場合、ブレークポイントはすべてのスレッドで発生します。 (継承元 DkmPendingBreakpoint)
UniqueId	この保留中のブレークポイント オブジェクトを一意に識別する Guid。 (継承元 DkmPendingBreakpoint)

メソッド

Close()	DkmPendingBreakpoint オブジェクト インスタンスを閉じます。 これにより、すべてのコンポーネントにわたって、このオブジェクトに関連付けられているすべてのリソースが解放されます。 これには、コンピューターまたはマネージド/ネイティブマーシャリング境界を越えたリソースが含まれます。 DkmPendingBreakpoint オブジェクトは、関連付けられている DkmProcess オブジェクトが閉じられると自動的に閉じられます。 このメソッドは、 オブジェクトを作成したコンポーネントによってのみ呼び出されます。 (継承元 DkmPendingBreakpoint)
Create(DkmProcess, Guid, DkmCompilerId, DkmThread, Boolean, String, String, String, DkmDataItem)	保留中の新しいブレークポイント オブジェクトを作成します。 作成後、返されたオブジェクトは引き続き無効になり、ブレークポイント マネージャーによって追跡されません。 初期化を完了するには、呼び出し元がブレークポイントに追加のプロパティを設定し、'Enable' または 'Enroll' を設定する必要があります。 呼び出し元は、作成されたオブジェクトが完了した後に閉じる役割を担います。
Disable(DkmWorkList, DkmCompletionRoutine<DkmDisablePendingBreakpointAsyncResult>)	保留中のブレークポイント オブジェクトを無効にして、起動しないようにします。 保留中のブレークポイントが既にバインドされている場合、バインドされたブレークポイントはすべて暗黙的に無効になります。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 (継承元 DkmPendingBreakpoint)
Enable(DkmWorkList, DkmCompletionRoutine<DkmEnablePendingBreakpointAsyncResult>)	将来バインドするブレークポイントのインスタンスがヒットするように、保留中のブレークポイントの状態を設定します。 保留中のブレークポイントがまだ登録されていない場合、このメソッドはブレークポイントも登録します。 保留中のブレークポイントを登録するには、現在読み込まれているモジュールに対してブレークポイントを解決し、ブレークポイント マネージャーがモジュールの読み込み時にバインドするブレークポイントの一覧にブレークポイントを追加します。 保留中のブレークポイントが既に登録されている場合、既存のバインドされたブレークポイントは自動的に有効になりません。 バインドされたブレークポイントは個別に有効にする必要があります。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 (継承元 DkmPendingBreakpoint)
Enroll(DkmWorkList, DkmCompletionRoutine<DkmEnrollPendingBreakpointAsyncResult>)	このメソッドは、保留中のブレークポイントを有効にせずに登録します。 その結果、ブレークポイント マネージャーが解決を試みるが、起動しないブレークポイントが生成されます。 保留中のブレークポイントを登録するには、現在読み込まれているモジュールに対してブレークポイントを解決し、ブレークポイント マネージャーがモジュールの読み込み時にバインドするブレークポイントの一覧にブレークポイントを追加します。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 (継承元 DkmPendingBreakpoint)
GetBoundBreakpoints()	GetBoundBreakpoints は、この DkmPendingBreakpoint オブジェクトの DkmBoundBreakpoint 要素を列挙します。 (継承元 DkmPendingBreakpoint)
GetDataItem<T>()	このコンテナー インスタンスに追加された 'T' のインスタンスを取得します。 このコンテナーに 'T' が含まれていない場合、この関数は null を返します。 (継承元 DkmDataContainer)
OnBreakpointBound(DkmBoundBreakpoint[])	ブレークポイントがバインドされたときのブレークポイント マネージャーからの通知。 ユーザー設定ブレークポイントの場合、この通知は AD7 AL に送信され、AD7 AL は Visual Studio デバッガー UI に IDebugBreakpointBoundEvent2 を起動します。 (継承元 DkmPendingBreakpoint)
OnBreakpointMessage(DkmBreakpointMessageLevel, DkmBreakpointSuggestedFix, Byte, String)	ブレークポイントのバインドの状態に関するブレークポイント マネージャーからの通知。 この API は、Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) で導入されました。 (継承元 DkmPendingBreakpoint)
OnBreakpointMessage(DkmBreakpointMessageLevel, DkmBreakpointSuggestedFix, String)	ブレークポイントのバインドの状態に関するブレークポイント マネージャーからの通知。 この API は、Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4) で導入されました。 (継承元 DkmPendingBreakpoint)
OnBreakpointMessage(DkmBreakpointMessageLevel, String)	ブレークポイントのバインドの状態に関するブレークポイント マネージャーからの通知。 (継承元 DkmPendingBreakpoint)
OnBreakpointUnbound(DkmBoundBreakpoint[], DkmBreakpointUnboundReason)	指定されたブレークポイントがバインドされていないことを示すブレークポイント マネージャーからの通知。 (継承元 DkmPendingBreakpoint)
OnHitWithError(DkmThread, Boolean, DkmBreakpointMessageLevel, String)	BreakpointHitWithError イベントを発生させます。 イベント シンク インターフェイスを実装するコンポーネントは、イベント通知を受け取ります。 このメソッドはイベントをエンキューし、コントロールはすぐに呼び出し元に戻ります。 この API は、Visual Studio 16 RTM (DkmApiVersion.VS16RTM) で導入されました。 (継承元 DkmPendingBreakpoint)
RemoveDataItem<T>()	このコンテナーから 'T' のインスタンスを削除します。 通常、オブジェクトが閉じられるとデータ コンテナーが自動的に空になるので、このメソッドを呼び出す必要があります。 (継承元 DkmDataContainer)
SetCondition(DkmWorkList, DkmBreakpointCondition, DkmCompletionRoutine<DkmSetPendingBreakpointConditionAsyncResult>)	この条件ブレークポイントのすべてのバインドされたブレークポイントで、言語レベルの条件を初期化、更新、またはクリアします。 同じブレークポイントに言語レベルの条件とヒット カウント条件の両方がある場合は、最初に言語レベルの条件が適用されます。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 (継承元 DkmPendingBreakpoint)
SetDataItem<T>(DkmDataCreationDisposition, T)	データ コンテナーに新しい項目を配置します。 (継承元 DkmDataContainer)
SetHitCountCondition(DkmWorkList, DkmBreakpointHitCountCondition, DkmCompletionRoutine<DkmSetPendingBreakpointHitCountConditionAsyncResult>)	この保留中のブレークポイントのすべてのバインドされたブレークポイントでヒットカウント条件を初期化、更新、またはクリアします。 同じブレークポイントに言語レベルの条件とヒット カウント条件の両方がある場合は、最初に言語レベルの条件が適用されます。 ヒット カウント条件は、保留中のブレークポイントでまとめて集計されるのではなく、バインドされた各ブレークポイントで個別に動作します。 たとえば、ヒット数がヒット #2 で停止するように構成され、ブレークポイントがそれぞれ 1 回ブレークポイントにヒットする 2 つの別々の場所に設定されている場合、個々のバインドされたブレークポイントが 2 回ヒットしていないため、UI は中断モードになりません。 このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。 場所の制約: API は IDE コンポーネント (コンポーネント レベル > 100,000) から呼び出す必要があります。 (継承元 DkmPendingBreakpoint)

明示的なインターフェイスの実装

IDisposable.Dispose()

特定の命令アドレス文字列でコード要素にバインドするように要求される保留中のブレークポイント。 IDE 内では、ユーザーが呼び出し履歴または逆アセンブリ ウィンドウにブレークポイントを設定した後、デバッガーが別のデバッグ セッションまたは同じデバッグ セッション内の別のプロセスでブレークポイントを再バインドするように求められたときに、これらのブレークポイントが作成されます。 (継承元 DkmPendingBreakpoint)