GetFieldData 関数 (wdbgexts.h)

GetFieldData 関数は、構造体内のメンバーの値を返します。

構文

ULONG GetFieldData(
  [in]  ULONG64 TypeAddress,
  [in]  LPCSTR  Type,
  [in]  LPCSTR  Field,
  [in]  ULONG   OutSize,
  [out] PVOID   pOutValue
);

パラメーター

[in] TypeAddress

ターゲットのメモリ内の構造体のアドレスを指定します。

[in] Type

構造体の型の名前を指定します。 これは、モジュール名 ( mymodule!mystruct など) で修飾できます。

[in] Field

値が返される構造体内のメンバーの名前を指定します。 サブメンバーは、ピリオドで区切られたパス ("myfield.mysubfield" など) を使用して指定できます。

TypeAddress が指す構造体のサイズが 8 バイト未満の場合、Field は NULL にすることができます。この場合、構造体全体が pOutValue にコピーされます。

[in] OutSize

バッファー pOutValue のサイズをバイト単位で指定します。

OutSize が返される値のサイズよりも小さい場合は、エラー メッセージが出力され、例外が発生します。例外が処理されるか無視された場合、戻り値は 0 です。 この場合、 pOutValue によって参照されるバッファーの末尾を超えるデータが上書きされる可能性があります。

[out] pOutValue

メンバーの値を受け取ります。 または、 Field が NULL の場合は、型の値です。

戻り値

関数が成功した場合の戻り値は 0 です。 それ以外の場合、戻り値は IG_DUMP_SYMBOL_INFOエラー コードです。

要件