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

[アーティクル]
08/07/2023

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

構文

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

パラメーター

[in] Count

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

[in, optional] Indices

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

[in] Start

Indexs が 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」を参照してください。