次の方法で共有

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

  • [アーティクル]

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

構文

HRESULT GetPseudoDescriptionWide(
  [in]            ULONG    Register,
  [out, optional] PWSTR    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 値 を参照してください。

リターン コード 形容
S_OK
 メソッドが成功しました。
E_FAIL
 レジスタの説明を使用できませんでした

備考

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

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

必要条件

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

関連項目

GetNumberPseudoRegisters

GetPseudoIndexByName

IDebugRegisters2 の