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

GetPseudoDescription メソッドは、名前と型を含む擬似レジスタの説明を返します。

構文

HRESULT GetPseudoDescription(
  [in]            ULONG    Register,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 TypeModule,
  [out, optional] PULONG   TypeId
);

パラメーター

[in] Register

説明を要求する擬似レジスタのインデックスを指定します。 インデックスは、常に 0 から擬似レジスタの数 ( GetNumberPseudoRegisters によって返されます) から 1 を引いた値の間にあります。

[out, optional] NameBuffer

擬似レジスタの名前を受け取ります。 NameBuffer が NULL の場合、この情報は返されません。

[in] NameBufferSize

NameBuffer が指定するバッファーのサイズを文字数で指定します。 このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] NameSize

擬似レジスタの名前のサイズを文字数で受け取ります。 このサイズには、'\0' 終端文字のスペースが含まれます。 NameSize が NULL の場合、この情報は返されません。

[out, optional] TypeModule

レジスタの型が属するモジュールのベース アドレスを受け取ります。 レジスタの型が不明な場合は、0 が返されます。 TypeModule が NULL の場合、情報は返されません。

[out, optional] TypeId

TypeModule で返されるモジュール内の型の型 ID を受け取ります。 型 ID が不明な場合は、0 が返されます。 TypeId が NULL の場合、情報は返されません。

戻り値

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

注釈

説明は、すべてのレジスタで常に使用できるわけではありません。 擬似レジスタに値がない場合 (たとえば、イベントが発生する前に $eventip に値がない場合や、擬似レジスタに対して型を決定できない場合、このメソッドはE_FAILを返します。

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

要件

こちらもご覧ください

GetNumberPseudoRegisters

GetPseudoIndexByName

IDebugRegisters2