IDebugRegisters2::GetInstructionOffset2 メソッド (dbgeng.h)

GetInstructionOffset2 メソッドは、現在のスレッドの現在の命令の場所を返します。

構文

HRESULT GetInstructionOffset2(
  [in]  ULONG    Source,
  [out] PULONG64 Offset
);

[in] Source

クエリを実行するレジスタソースを指定します。

使用可能な値を次の表に示します。

値	ソースの登録
DEBUG_REGSRC_DEBUGGEE	ターゲットからレジスタ情報をフェッチします。
DEBUG_REGSRC_EXPLICIT	現在の明示的なレジスタコンテキストからレジスタ情報をフェッチします。
DEBUG_REGSRC_FRAME	現在のスコープのレジスタコンテキストからレジスタ情報をフェッチします。メモスタックアンワインドでは、レジスタコンテキストの正確な更新は保証されないため、スコープフレームのレジスタコンテキストは、すべてのケースで正確ではない可能性があります。

[out] Offset

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

この一覧には、発生する可能性のあるすべてのエラーが含まれていません。考えられるエラーの一覧については、「 HRESULT 値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。

このメソッドによって返される値の意味は、アーキテクチャに依存します。特に、Itanium ベースのプロセッサの場合、返される仮想アドレスはバンドル内のアドレスを示すことができます。

GetInstructionOffset メソッドは、このメソッドと同じタスクを実行しますが、常にターゲットをレジスタソースとして使用します。

IDebugRegisters インターフェイスとその他のレジスタ関連のメソッドの概要については、「Registers」を参照してください。

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (DbgEng.h を含む)