IDebugHost::GetCurrentContext メソッド (dbgmodel.h)
GetCurrentContext メソッドは、デバッガー ホストの現在の状態を表すインターフェイスを返します。 この正確な意味はホストに任されていますが、通常はデバッグ ホストのユーザー インターフェイスでアクティブなセッション、プロセス、アドレス空間などが含まれます。 返されるコンテキスト オブジェクトは、呼び出し元に対してほとんど不透明ですが、デバッグ ホストへの呼び出し間で渡すことが重要なオブジェクトです。 呼び出し元がメモリの読み取りなどの場合、メモリが読み取られるプロセスとアドレス空間を把握することが重要です。 この概念は、このメソッドから返されるコンテキスト オブジェクトの概念にカプセル化されます。
データ モデル内のすべてのオブジェクトとシンボルには、必要に応じて、このようなコンテキスト情報が関連付けられています。 また、多くの場合、コンテキストが 1 つのオブジェクトから、既存のオブジェクトのプロパティとして作成された新しいオブジェクトに渡されることが一般的です。 このようなオブジェクトがデバッグ ホスト自体によって作成されると、返されるオブジェクト内に追加のコンテキスト情報が埋め込まれる可能性があります (たとえば、スレッドの Stack プロパティは、スタックがコンテキスト内で参照するスレッドに関する情報を埋め込むことができます)。
構文
HRESULT GetCurrentContext(
IDebugHostContext **context
);
パラメーター
context
ホストの現在のコンテキストを表す オブジェクトがここで返されます。
戻り値
このメソッドは、成功または失敗を示す HRESULT を返します。 コンテキスト情報の概念を持たないホストは、ここでE_NOTIMPLを返す場合があります。
注釈
コード サンプル
ComPtr<IDebugHost> spHost; /* get the debug host */
ComPtr<IDebugHostContext> spContext;
if (SUCCEEDED(spHost->GetCurrentContext(&spContext)))
{
// spContext now contains an opaque object representing the current UI
// state of the debugger (e.g.: what session/process/thread the debug UI
// is focused on)
}
要件
| 要件 | 値 |
|---|---|
| Header | dbgmodel.h |