次の方法で共有

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

  • [アーティクル]

GetValues メソッドは、ターゲットの レジスタの値を取得します。

構文

HRESULT GetValues(
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [out]          PDEBUG_VALUE Values
);

パラメーター

[in] Count

値が要求されるレジスタの数を指定します。

[in, optional] Indices

値の取得元となるレジスタのインデックスを含む配列を指定します。 この配列内の要素の数は、count です。 インデックス が NULL 場合は、代わりに開始 使用されます。

[in] Start

インデックス が NULL 場合、レジスタはこのインデックスから連続して読み取られます。 それ以外の場合は無視されます。

[out] Values

レジスタの値を受け取ります。 この配列が保持する要素の数は、count です。 このパラメーター型の説明については、DEBUG_VALUE を参照してください。

戻り値

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

リターン コード 形容
S_OK
 メソッドが成功しました。
E_UNEXPECTED
 ターゲットにアクセスできないか、いずれかのレジスタにアクセスできませんでした。
E_INVALIDARG
 いずれかのレジスタのインデックスの値が、ターゲット マシン上のレジスタの数より大きい。 部分的な結果が得られた可能性があります。読み取りできなかったレジスタの型はDEBUG_VALUE_INVALID。

備考

GetValues は、ターゲットのいくつかのレジスタの値を取得します。

戻り値がS_OKされていない場合、一部のレジスタがまだ読み取られた可能性があります。 ターゲットにアクセスできなかった場合、戻り値の型はE_UNEXPECTEDされ、値 は変更されません。それ以外の場合、値 には部分的な結果が含まれます。読み取ることができなかったレジスタの型はDEBUG_VALUE_INVALID。 戻り値E_UNEXPECTEDの場合のあいまいさは、このメソッドを呼び出す前に Values のメモリを 0 に設定することで回避できます。

1 つのレジスタのみの値を受け取るには、代わりに GetValue メソッドを使用します。

GetValues2 メソッドは、このメソッドと同じタスクを実行しますが、レジスタ ソースを指定することもできます。

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (DbgEng.h を含む)

関連項目

GetValue を する

GetValues2 を する

IDebugRegisters の

IDebugRegisters2 の