IDebugSymbols3::GetScope メソッド (dbgeng.h)

[アーティクル]
02/23/2024

GetScope メソッドは、現在のスコープに関する情報を返します。

構文

HRESULT GetScope(
  [out, optional] PULONG64           InstructionOffset,
  [out, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [out, optional] PVOID              ScopeContext,
  [in]            ULONG              ScopeContextSize
);

パラメーター

[out, optional] InstructionOffset

現在のスコープの現在の命令のプロセスの仮想アドレス空間内の場所を受け取ります。

[out, optional] ScopeFrame

現在のスコープのスタックフレームを表す DEBUG_STACK_FRAME 構造体を受け取ります。

[out, optional] ScopeContext

現在のスコープのスレッドコンテキストを受け取ります。スレッドコンテキストの型は、ターゲットの有効なプロセッサの CONTEXT 構造体です。 buffer ScopeContext は、この構造体を保持するのに十分な大きさである必要があります。

[in] ScopeContextSize

バッファー ScopeContext のサイズを指定します。

戻り値

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。
E_INVALIDARG	バッファー ScopeContext のサイズが、スコープのコンテキストを保持するのに十分な大きさではなかった。