次の方法で共有


DkmClrModuleInstance クラス

定義

'DkmClrModuleInstance' は、共通言語ランタイムに読み込まれるモジュールに使用されます。

派生クラス: DkmClrNcModuleInstance

public ref class DkmClrModuleInstance : Microsoft::VisualStudio::Debugger::DkmModuleInstance
[System.Runtime.InteropServices.Guid("29da4ffa-6063-6232-46dd-64d14cf56ddf")]
public class DkmClrModuleInstance : Microsoft.VisualStudio.Debugger.DkmModuleInstance
[<System.Runtime.InteropServices.Guid("29da4ffa-6063-6232-46dd-64d14cf56ddf")>]
type DkmClrModuleInstance = class
    inherit DkmModuleInstance
Public Class DkmClrModuleInstance
Inherits DkmModuleInstance
継承
継承
派生
属性

プロパティ

AppDomain

DkmClrAppDomain は、デバッグ中のプロセス内の CLR アプリ ドメインを表します。

BaseAddress

[省略可能]モジュールが読み込まれた場所の開始メモリ アドレス。 モジュールが連続したメモリ ブロックに読み込まれていない場合、この値は 0 になります。

(継承元 DkmModuleInstance)
ClrFlags

CLR によって読み込まれた DkmModuleInstance の特性を示すフラグ。

Connection

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

(継承元 DkmModuleInstance)
Flags

DkmModuleInstance の特性を示すフラグ。

(継承元 DkmModuleInstance)
FullName

完全修飾モジュール名。 ファイル ベースのモジュールの場合、これはモジュールへの完全なパスです (例: c:\windows\system32\kernel32.dll。

(継承元 DkmModuleInstance)
ILImageSize

シンボル サーバーの参照に関連するため、このモジュールの IL イメージのサイズを指定します。 デスクトップ .NET Frameworkでは、ngen の場合は生のイメージ サイズとは異なる IL イメージ サイズが指定されます。 これは、IL のみのイメージがシンボル サーバーでインデックスが作成されるためです。 .NET Core ngen と実行準備完了の場合は、ngen/ready to run image がインデックス付きであり、IL のみのイメージ サイズに基づいてルックアップを実行したくないので、生のイメージ サイズが指定されます。

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

IsDisabled

このモジュール インスタンスが無効になっているかどうかを示します。 無効なモジュールは、デバッガーによってほとんど無視されます。 ネイティブ モジュールの場合、無効なモジュールのアドレス範囲はマップされていないかのように扱われます。 CLR モジュールの場合、これらのモジュールのすべてのフレームは呼び出し履歴から非表示になります。

(継承元 DkmModuleInstance)
IsUnloaded

このオブジェクトに対して 'unloaded' イベントが発生した場合 (例: DkmThread::Unload が呼び出された場合)、またはオブジェクトが閉じている場合は true を返します。 この状態を同期せずに確認する場合は、読み取った後に返される状態が正確でなくなる可能性があるため、注意が必要です。

(継承元 DkmDataContainer)
LoadContext

このモジュールが読み込まれたコンテキストの文字列の説明。 例: 'Win32' または 'CLR v2.0.50727: 既定のドメイン'。

(継承元 DkmModuleInstance)
LoadOrder

このモジュールまで読み込まれ、このモジュールを含むモジュール インスタンスの数の整数。 各ランタイム インスタンスは、独自の読み込み順序数を追跡します。

(継承元 DkmModuleInstance)
MemoryLayout

モジュールをメモリにレイアウトする方法を示す列挙。

(継承元 DkmModuleInstance)
MinidumpInfoPart

[省略可能]'MinidumpInfoPart' は、ミニダンプの DkmProcess 内のモジュールに関する追加情報を伝達するために使用されます。

(継承元 DkmModuleInstance)
Module

[省略可能]このモジュール インスタンスに関連付けられているモジュール (DkmModule) のシンボル ハンドラーの表現。 この値は、最初は null であり、シンボルがこのモジュール インスタンスに関連付けられている場合といつ割り当てられます。

(継承元 DkmModuleInstance)
Mvid

読み込まれたモジュールのモジュール バージョン識別子。 これは、dll/exe のビルド時にリンカー/コンパイラによって exe/dll に埋め込まれる一意の値です。 dll/exe がコンパイルされるたびに、新しい値が生成されます。

Name

モジュール名の短い表現。 ファイル ベースのモジュールの場合、これはファイル名と拡張子 (例: kernel32.dll) です。

(継承元 DkmModuleInstance)
Process

DkmProcess は、デバッグ中のターゲット プロセスを表します。 デバッガーはプロセスをデバッグするため、これはデバッグの基本的な単位です。 DkmProcess は、システム プロセスまたはミニダンプなどの仮想プロセスを表すことができます。

(継承元 DkmModuleInstance)
RuntimeInstance

ターゲット プロセスで実行されている CLR インスタンスを表します。

Size

[省略可能]モジュールのメモリ領域のバイト数。 モジュールが連続したメモリ ブロックに読み込まれていない場合、この値は 0 になります。

(継承元 DkmModuleInstance)
SymbolFileId

[省略可能]このモジュールのシンボルを見つけるために必要な情報が含まれています。 Win32 では、この情報はIMAGE_DEBUG_DIRECTORY内に含まれます。

(継承元 DkmModuleInstance)
TagValue

DkmModuleInstance は抽象基本クラスです。 この列挙型は、このオブジェクトがどの派生クラスのインスタンスであるかを示します。

(継承元 DkmModuleInstance)
TimeDateStamp

読み込まれたモジュールがビルドされた日時。 この値は、読み込まれたモジュールのIMAGE_NT_HEADERSから取得されます。 測定単位は FILETIME 値で、1601 年 1 月 1 日 (UTC) 以降の 100 ナノ秒間隔の数を表す 64 ビット値です。

(継承元 DkmModuleInstance)
UniqueId

DkmModuleInstance オブジェクトを一意に識別します。

(継承元 DkmModuleInstance)
Version

[省略可能]ファイルのバージョン情報。

(継承元 DkmModuleInstance)

メソッド

CanDecompileMethod(DkmClrMethodId)

指定したメソッドを逆コンパイルできるかどうかを示します。

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

この API は、Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5) で導入されました。

CanDecompileModule(DkmDecompilerMode)

モジュールを特定のモードで逆コンパイルできるかどうかを示します。

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

この API は、Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) で導入されました。

ClearTransitionModuleFlag()

ランタイム インスタンスは、このメソッドを呼び出して、モジュールを境界モジュールとしてマークします。 ステップ実行時に、ステップが境界モジュールにヒットした場合はランタイムがチェックし、存在する場合はステップアービトレーションを開始する必要があります。 一部のランタイムでは、この要求を受け入ることができない場合があることに注意してください。 ディスパッチャーは、FlagAsTransitionModule が呼び出された回数を保持します。 ClearTransitionModuleFlag に対する呼び出しの数が一致する場合にのみ、モジュールは遷移モジュールと見なされなくなります。

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

(継承元 DkmModuleInstance)
Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

新しい DkmClrModuleInstance オブジェクト インスタンスをCreateします。

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

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

Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, UInt32, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

新しい DkmClrModuleInstance オブジェクト インスタンスをCreateします。

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

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

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

Decompile()

モジュールのコードを C# に逆コンパイルし、このソースが埋め込まれた新しいポータブル PDB を作成します。 このシンボル ファイルを共有するすべてのモジュールは、これらの更新されたシンボルの使用を開始します。

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

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

(継承元 DkmModuleInstance)
Decompile(DkmDecompilerMode, String, Int32)

モジュールのコードを C# に逆コンパイルし、このソースが埋め込まれた新しいポータブル PDB を作成します。 このシンボル ファイルを共有するすべてのモジュールでは、これらの更新されたシンボルの使用が開始されます。 実装では、エラー時にS_OKを返し、実際の HRESULT と 'HR' パラメーターと 'ErrorMessage' パラメーターを使用して追加のエラー情報を返す必要があります。

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

この API は、Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) で導入されました。

Decompile(DkmWorkList, DkmCompletionRoutine<DkmDecompileAsyncResult>)

モジュールのコードを C# に逆コンパイルし、このソースが埋め込まれた新しいポータブル PDB を作成します。 このシンボル ファイルを共有するすべてのモジュールは、これらの更新されたシンボルの使用を開始します。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

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

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

(継承元 DkmModuleInstance)
Decompile(DkmWorkList, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

モジュールのコードを C# に逆コンパイルし、このソースが埋め込まれた新しいポータブル PDB を作成します。 このシンボル ファイルを共有するすべてのモジュールは、これらの更新されたシンボルの使用を開始します。 実装では、エラー時にS_OKを返し、実際の HRESULT と 'HR' パラメーターと 'ErrorMessage' パラメーターを使用して追加のエラー情報を返す必要があります。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

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

この API は、Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3) で導入されました。

(継承元 DkmModuleInstance)
Decompile(DkmWorkList, DkmDecompilerMode, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

モジュールのコードを C# に逆コンパイルし、このソースが埋め込まれた新しいポータブル PDB を作成します。 このシンボル ファイルを共有するすべてのモジュールでは、これらの更新されたシンボルの使用が開始されます。 実装では、エラー時にS_OKを返し、実際の HRESULT と 'HR' パラメーターと 'ErrorMessage' パラメーターを使用して追加のエラー情報を返す必要があります。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。

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

この API は、Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) で導入されました。

Decompile(String, Int32)

モジュールのコードを C# に逆コンパイルし、このソースが埋め込まれた新しいポータブル PDB を作成します。 このシンボル ファイルを共有するすべてのモジュールは、これらの更新されたシンボルの使用を開始します。 実装では、エラー時にS_OKを返し、実際の HRESULT と 'HR' パラメーターと 'ErrorMessage' パラメーターを使用して追加のエラー情報を返す必要があります。

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

この API は、Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3) で導入されました。

(継承元 DkmModuleInstance)
DecompileDocument(DkmWorkList, String, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

ドキュメントのコードを C# に逆コンパイルし、含まれているモジュールに関連付けられているシンボル ファイルを、必要なデバッグ情報と埋め込みソースで更新します。 このシンボル ファイルを共有するすべてのモジュールでは、これらの更新されたシンボルの使用が開始されます。 実装では、エラー時にS_OKを返し、実際の HRESULT と 'HR' パラメーターと 'ErrorMessage' パラメーターを使用して追加のエラー情報を返す必要があります。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。

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

この API は、Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5) で導入されました。

DecompileDocument(String, String, Int32)

ドキュメントのコードを C# に逆コンパイルし、含まれているモジュールに関連付けられているシンボル ファイルを、必要なデバッグ情報と埋め込みソースで更新します。 このシンボル ファイルを共有するすべてのモジュールでは、これらの更新されたシンボルの使用が開始されます。 実装では、エラー時にS_OKを返し、実際の HRESULT と 'HR' パラメーターと 'ErrorMessage' パラメーターを使用して追加のエラー情報を返す必要があります。

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

この API は、Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5) で導入されました。

DecompileMethods(DkmWorkList, ReadOnlyCollection<DkmClrMethodId>, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

メソッドのコードを C# に逆コンパイルし、含まれているモジュールに関連付けられているシンボル ファイルを、必要なデバッグ情報と埋め込みソースで更新します。 このシンボル ファイルを共有するすべてのモジュールでは、これらの更新されたシンボルの使用が開始されます。 実装では、エラー時にS_OKを返し、実際の HRESULT と 'HR' パラメーターと 'ErrorMessage' パラメーターを使用して追加のエラー情報を返す必要があります。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元は、完了ルーチンを通じて要求が完了したことを通知されます。

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

この API は、Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5) で導入されました。

DecompileMethods(ReadOnlyCollection<DkmClrMethodId>, String, Int32)

メソッドのコードを C# に逆コンパイルし、含まれているモジュールに関連付けられているシンボル ファイルを、必要なデバッグ情報と埋め込みソースで更新します。 このシンボル ファイルを共有するすべてのモジュールでは、これらの更新されたシンボルの使用が開始されます。 実装では、エラー時にS_OKを返し、実際の HRESULT と 'HR' パラメーターと 'ErrorMessage' パラメーターを使用して追加のエラー情報を返す必要があります。

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

この API は、Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5) で導入されました。

FlagAsTransitionModule()

ランタイム インスタンスは、このメソッドを呼び出して、モジュールを境界モジュールとしてマークします。 ステップ実行時に、ステップが境界モジュールにヒットした場合はランタイムがチェックし、存在する場合はステップアービトレーションを開始する必要があります。 一部のランタイムでは、この要求を受け入ることができない場合があることに注意してください。 ディスパッチャーは、これが呼び出された回数を保持します。 ClearTransitionModuleFlag に対して一致する数の呼び出しが行われた場合にのみ、モジュールは遷移モジュールとは見なされなくなります。

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

(継承元 DkmModuleInstance)
GetBaselineMetaDataBytes()

特定のモジュールから CLR メタデータのベースライン バイトを取得します。

この API は、Visual Studio 15 Update 5 (DkmApiVersion.VS15Update5) で導入されました。

GetBaselineMetaDataBytesPtr(UInt32)

指定されたモジュールの元の生メタデータ バイトへのポインターを取得します。

場所の制約: なし。

この API は、Visual Studio 15 Update 5 (DkmApiVersion.VS15Update5) で導入されました。

GetCorObject()

ICorDebugModule オブジェクトへの直接アクセスを提供します。このオブジェクトは、式エバリュエーターまたはその他のコンポーネントを使用してアプリ ドメインを検査できます。

返されるインターフェイスは、ターゲット プロセスの検査にのみ使用できます。実行の制御には使用しないでください (ステップ実行なし、ブレークポイントなし、続行なしなど)。 これはサポートされていないため、未定義の動作になります。

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

GetDataItem<T>()

このコンテナー インスタンスに追加された 'T' のインスタンスを取得します。 このコンテナーに 'T' が含まれていない場合、この関数は null を返します。

(継承元 DkmDataContainer)
GetEncAvailability(String)

対応するマネージド モジュール インスタンスに対して Edit と Continue がサポートされているかどうかを確認します。

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

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

GetEncILDelta(Int32)

CLR モジュール インスタンスに関連付けられている IL デルタのクエリを実行します。 IL デルタは、コード変更の結果のバイトであり、いくつかのメソッドに影響する可能性があります。 これは、モジュール内の変更されたメソッドに関する情報を照会するときに VIL によって使用されます。

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

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

GetGPUDisassembly(UInt64, UInt32, Boolean, Boolean)

デバッグ対象モジュール インスタンスのアドレス範囲の逆アセンブリを取得します。

(継承元 DkmModuleInstance)
GetGPUDisassemblySize()

デバッグ対象モジュール インスタンスの逆アセンブリ サイズを返します。

(継承元 DkmModuleInstance)
GetLocalSignatureToken(Int32)

メソッド トークンが指定されたローカル変数シグネチャの署名トークンを取得します。

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

GetMetaDataBytes()

特定のモジュールから CLR メタデータのバイトを取得します。 その後、これらのバイトを IMetaDataDispenser::OpenScope に渡してメタデータをデコードできます。

GetMetaDataBytesPtr(UInt32)

指定されたモジュールの生メタデータ バイトへのポインターを取得します。

注: モジュールが a) アンロードされている場合、または b) が変更された場合、このポインター値は無効になります。 これらのシナリオを検出するには、a) モジュール インスタンスにデータ項目を追加します。 OnClose メソッドが呼び出された後 (モジュール インスタンスがアンロードされるときに) ポインターが無効になります。 b) IDkmClrModuleModifiedNotification を実装します。

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

GetMetaDataFileInfo(Boolean, UInt32, UInt32)

ディスク上のファイルからメタデータを直接読み取るために必要な情報を取得します。

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

GetMetaDataImport()

特定のモジュールから CLR メタデータを取得します。 メタデータの詳細については、MSDN の IMetaDataImport ドキュメントを参照してください。

注: この API をマネージド コードから使用する場合、呼び出し元は細心の注意を払う必要があります。 IMetaDataImport 実装では、デバッグ対象ファイルへのファイル ハンドルを保持できます。ファイル ハンドルは、COM 参照カウントが 0 に達した場合にのみ閉じられます。 そのため、GC がオブジェクトを解放できることを検出するのを待つのではなく、手動で解放する必要があります (Marshal.IsComObject + Marshal.ReleaseComObject)。 テスト時には、メタデータ リーダーが小さなファイルを処理するときに読み取り用にファイルをロックしたままにすることはされないため、デバッグ対象ファイルに少なくとも 64 KB のメタデータがあることを確認してください。

GetMetadataStatus()

メタデータの状態を取得します。

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

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

GetMethodTokens(DkmWorkList, String, String, DkmCompletionRoutine<DkmGetMethodTokensAsyncResult>)

クラスを指定したメソッドのメタデータ トークンを取得するためのメカニズムを提供します。 IMetaDataImport::EnumMethodsWithName と同等です。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

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

GetMethodTokens(String, String, Int32[])

クラスを指定したメソッドのメタデータ トークンを取得するためのメカニズムを提供します。 IMetaDataImport::EnumMethodsWithName と同じです。

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

GetNextGPUInstructionAddress(UInt64)

開始アドレスに対する次の命令のアドレスを返します。

(継承元 DkmModuleInstance)
GetSymbolLoadInformation()

シンボルが検索されたさまざまな場所と、その場所を確認した結果を説明する文字列を返します。 この情報は、モジュール ウィンドウの [シンボル読み込み情報] を設定するために使用されます。

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

(継承元 DkmModuleInstance)
GetSymbolSearchResult()

このモジュール インスタンスに関連付けられているシンボル検索結果を取得します。

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

この API は、Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3) で導入されました。

(継承元 DkmModuleInstance)
GetSymbolSearchResult(DkmWorkList, DkmCompletionRoutine<DkmGetSymbolSearchResultAsyncResult>)

このモジュール インスタンスに関連付けられているシンボル検索結果を取得します。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

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

この API は、Visual Studio 17 Update 3 (DkmApiVersion.VS17Update3) で導入されました。

(継承元 DkmModuleInstance)
GetSymbolStatusMessage(Boolean)

現在のシンボルの状態のローカライズされた文字列の説明を取得します。

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

(継承元 DkmModuleInstance)
GetSymbolStatusMessage(DkmWorkList, Boolean, DkmCompletionRoutine<DkmGetSymbolStatusMessageAsyncResult>)

現在のシンボルの状態のローカライズされた文字列の説明を取得します。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

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

(継承元 DkmModuleInstance)
GetSymUnmanagedReader()

この API は、CLR モジュールの部分的な ISymUnmanagedReader2 実装を提供します。

場所制約: リモート接続の両側に ISymUnmanagedReader2 の部分的な実装を提供します。

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

GetTypeIdForTypeName(String)

指定した型名の型 ID を返します。

この API は、Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8) で導入されました。

InterpretManagedMethod(DkmClrMethodId, ReadOnlyCollection<DkmClrType>, ReadOnlyCollection<DkmClrType>, DkmILInterpreterValue, ReadOnlyCollection<DkmILInterpreterValue>, Int32, DkmILInterpreterOptions, String)

メソッドの MSIL コードを解釈して、オブジェクトに対するメソッドの実行をシミュレートします。 メソッドの結果が呼び出し元に返されます。 ただし、メソッドがターゲットで実際に実行されている関数評価とは異なり、メソッドを解釈してもメソッドは実際には実行されず、代わりにメソッドの動作をシミュレートするだけです。 メソッドは実際には実行されないため、メソッドの解釈が完了すると、メソッドの実行に起因する副作用はすべて破棄され、ターゲット プロセスは呼び出し前と同じ状態になります。

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

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

IsSuppressed()

このメソッドを使用すると、コンポーネントはモジュールのモジュール読み込みイベントが抑制されたかどうかを判断できます。

この API は、Visual Studio 12 Update 3 (DkmApiVersion.VS12Update3) で導入されました。

(継承元 DkmModuleInstance)
IsTransitionModule()

ランタイム インスタンスでこのモジュールに遷移モジュールとしてフラグが設定されている場合は true を返します。

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

(継承元 DkmModuleInstance)
IsUserCode()

モジュールがユーザー コードと見なされるかどうかを判断します。

場所の制約: このメソッドは IDE コンポーネントから呼び出すことができます。 Visual Studio 2013 Update 2 以降では、マネージド コードのモニター コンポーネントからこれを呼び出すこともできます。 Visual Studio 2017 Update 8 から、API の CallDirection は 'Normal' から '双方向' にされ、任意のコンポーネントから呼び出すようになりました。AsyncCaller は 'true' に設定され、CallerLocationConstraint は 'NoMarshalling' から 'None' に設定されました。

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

(継承元 DkmModuleInstance)
IsUserCode(DkmWorkList, DkmCompletionRoutine<DkmModuleInstanceIsUserCodeAsyncResult>)

モジュールがユーザー コードと見なされるかどうかを判断します。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

場所の制約: このメソッドは IDE コンポーネントから呼び出すことができます。 Visual Studio 2013 Update 2 以降では、マネージド コードのモニター コンポーネントからこれを呼び出すこともできます。 Visual Studio 2017 Update 8 から、API の CallDirection は 'Normal' から '双方向' にされ、任意のコンポーネントから呼び出すようになりました。AsyncCaller は 'true' に設定され、CallerLocationConstraint は 'NoMarshalling' から 'None' に設定されました。

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

(継承元 DkmModuleInstance)
OnBinaryLoaded(String)

BinaryLoaded イベントを発生させます。 イベント シンク インターフェイスを実装するコンポーネントは、イベント通知を受け取ります。 すべてのコンポーネントに通知されると、コントロールが返されます。

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

(継承元 DkmModuleInstance)
OnBinaryReloadOpportunity()

BinaryReloadOpportunity イベントを発生させます。 イベント シンク インターフェイスを実装するコンポーネントは、イベント通知を受け取ります。 すべてのコンポーネントに通知されると、コントロールが返されます。

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

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

(継承元 DkmModuleInstance)
OnModuleModified()

このメソッドは、EnC または動的に出力されたコードが原因でモジュールが変更されたときに呼び出されます。

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

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

(継承元 DkmModuleInstance)
OnSymbolsLoaded(DkmModule, Boolean)

このメソッドは、IDkmModuleSymbolsLoaded.RaiseSymbolsLoadedEvent の呼び出しに応答して、基本デバッグ モニターによって呼び出されます。 このメソッドは、イベント スレッドから、または再読み込みの一部として要求スレッドから呼び出す必要があります。 基本デバッグ モニターは、同期的にイベント スレッドに切り替え、ターゲット プロセスを一時停止し、OnSymbolsLoaded を呼び出す必要があります。

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

(継承元 DkmModuleInstance)
OnSymbolsUpdated(DkmModule)

ModuleSymbolsUpdated イベントを発生させます。 イベント シンク インターフェイスを実装するコンポーネントは、イベント通知を受け取ります。 すべてのコンポーネントに通知されると、コントロールが返されます。

(継承元 DkmModuleInstance)
ReadSymbols()

このメソッドは、シンボル がデバッグ対象のメモリに存在する DkmModuleInstances のシンボルを読み取るためにシンボル ハンドラーによって呼び出されます。

(継承元 DkmModuleInstance)
RemoveDataItem<T>()

このコンテナーから 'T' のインスタンスを削除します。 通常、オブジェクトが閉じられるとデータ コンテナーが自動的に空になるので、このメソッドを呼び出す必要があります。

(継承元 DkmDataContainer)
ResolveTypeName(String, ReadOnlyCollection<DkmClrType>)

型名を型に解決します。 型がジェネリックの場合、ジェネリック パラメーターはインスタンス化されません。

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

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

SetDataItem<T>(DkmDataCreationDisposition, T)

データ コンテナーに新しい項目を配置します。

(継承元 DkmDataContainer)
SetDisabled(Boolean)

モジュールで無効な状態をUpdatesします。 このメソッドは、ModuleInstanceLoad イベントからのみ呼び出されます。 モジュールを無効にする場合は、モジュールの読み込みイベントも抑制するのが一般的です。

(継承元 DkmModuleInstance)
SetModule(DkmModule, Boolean)

このメソッドは、DkmModule を DkmModuleInstance に関連付け、ModuleSymbolsLoaded イベントをトリガーするためにシンボル プロバイダーによって呼び出されます。 これは、DkmModuleInstance オブジェクトに対して 1 回だけ呼び出されます。 この API を呼び出すと、DkmModule-DkmModuleInstance<> 関連付けが確立され、ModuleSymbolsLoaded イベントが発生します。

(継承元 DkmModuleInstance)
TryLoadBinary()

更新されたシンボル パスを使用して、以前に読み込みに失敗したバイナリを読み込もうとします。

(継承元 DkmModuleInstance)
TryLoadBinary(DkmWorkList, DkmCompletionRoutine<DkmTryLoadBinaryAsyncResult>)

更新されたシンボル パスを使用して、以前に読み込みに失敗したバイナリを読み込もうとします。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

(継承元 DkmModuleInstance)
TryLoadDecompiledSymbols()

モジュールのキャッシュされた逆コンパイルされたシンボルを読み込もうとします。

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

この API は、Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5) で導入されました。

TryLoadDecompiledSymbols(DkmWorkList, DkmCompletionRoutine<DkmTryLoadDecompiledSymbolsAsyncResult>)

モジュールのキャッシュされた逆コンパイルされたシンボルを読み込もうとします。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

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

この API は、Visual Studio 17 Update 5 (DkmApiVersion.VS17Update5) で導入されました。

TryLoadSymbols()

モジュールの読み込み時にシンボルが見つからなかった DkmModuleInstances のシンボルの読み込みを開始するために呼び出されます。

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

(継承元 DkmModuleInstance)
TryLoadSymbols(DkmSymbolLoadFlags)

モジュールの読み込み時にシンボルが見つからなかった DkmModuleInstances のシンボルの読み込みを開始するために呼び出されます。

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

この API は、Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4) で導入されました。

(継承元 DkmModuleInstance)
TryLoadSymbols(DkmWorkList, DkmCompletionRoutine<DkmTryLoadSymbolsAsyncResult>)

モジュールの読み込み時にシンボルが見つからなかった DkmModuleInstances のシンボルの読み込みを開始するために呼び出されます。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

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

(継承元 DkmModuleInstance)
TryLoadSymbols(DkmWorkList, DkmSymbolLoadFlags, DkmCompletionRoutine<DkmTryLoadSymbolsAsyncResult>)

モジュールの読み込み時にシンボルが見つからなかった DkmModuleInstances のシンボルの読み込みを開始するために呼び出されます。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

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

この API は、Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4) で導入されました。

(継承元 DkmModuleInstance)
TryLoadSymbolsCallback()

モジュールの読み込み時にシンボルが見つからなかった DkmModuleInstances のシンボルの読み込みを開始するために呼び出されます。

場所の制約: これは、クライアントまたはサーバーから呼び出すことができます。 このサーバー実装は、不要なネットワーク呼び出しを防ぐためのキャッシュです。 クライアントは、"実際の" 実装に直接移動します。これにより、reattempts が早期に返されることが保証されます。

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

(継承元 DkmModuleInstance)
TryLoadSymbolsCallback(DkmWorkList, DkmCompletionRoutine<DkmTryLoadSymbolsCallbackAsyncResult>)

モジュールの読み込み時にシンボルが見つからなかった DkmModuleInstances のシンボルの読み込みを開始するために呼び出されます。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

場所の制約: これは、クライアントまたはサーバーから呼び出すことができます。 このサーバー実装は、不要なネットワーク呼び出しを防ぐためのキャッシュです。 クライアントは、"実際の" 実装に直接移動します。これにより、reattempts が早期に返されることが保証されます。

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

(継承元 DkmModuleInstance)
TryLoadSymbolsCallback177(DkmSymbolLoadFlags)

モジュールの読み込み時にシンボルが見つからなかった DkmModuleInstances のローカルに存在するシンボルの読み込みを開始するために呼び出されます。

場所の制約: これは、クライアントまたはサーバーから呼び出すことができます。 このサーバー実装は、不要なネットワーク呼び出しを防ぐためのキャッシュです。 クライアントは、"実際の" 実装に直接移動します。これにより、reattempts が早期に返されることが保証されます。

この API は、Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) で導入されました。

(継承元 DkmModuleInstance)
TryLoadSymbolsCallback177(DkmWorkList, DkmSymbolLoadFlags, DkmCompletionRoutine<DkmTryLoadSymbolsCallback177AsyncResult>)

モジュールの読み込み時にシンボルが見つからなかった DkmModuleInstances のローカルに存在するシンボルの読み込みを開始するために呼び出されます。

このメソッドは、指定した作業リストに新しい作業項目を追加し、作業項目が追加されると を返します。 作業項目の実際の処理は非同期です。 呼び出し元には、完了ルーチンを介して要求が完了したことを通知されます。

場所の制約: これは、クライアントまたはサーバーから呼び出すことができます。 このサーバー実装は、不要なネットワーク呼び出しを防ぐためのキャッシュです。 クライアントは、"実際の" 実装に直接移動します。これにより、reattempts が早期に返されることが保証されます。

この API は、Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) で導入されました。

(継承元 DkmModuleInstance)
TryResolveToken(DkmStackWalkFrame, Int32, DkmClrType, Int32)

このモジュールのスコープ内から定義モジュールへのトークンの解決を試みます。

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

この API は、Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8) で導入されました。

Unload()

Unload オブジェクトをアンロード済みとしてマークし、イベント シンク インターフェイスを実装するコンポーネントに通知します。 すべてのコンポーネントに通知されると、コントロールが返されます。

このメソッドは、 オブジェクトを作成したコンポーネントによってのみ呼び出されます。

(継承元 DkmModuleInstance)

適用対象