次の方法で共有

FIELD_INFO構造体 (wdbgexts.h)

  • [アーティクル]

FIELD_INFO 構造体は、構造体内のメンバーに関する情報を提供するために、IG_DUMP_SYMBOL_INFOIoctl 操作によって使用されます。

構文

typedef struct _FIELD_INFO {
  PUCHAR    fName;
  PUCHAR    printName;
  ULONG     size;
  ULONG     fOptions;
  ULONG64   address;
  union {
    PVOID fieldCallBack;
    PVOID pBuffer;
  };
  ULONG     TypeId;
  ULONG     FieldOffset;
  ULONG     BufferSize;
  struct {
    USHORT Position;
    USHORT Size;
  } BitField;
  _BitField _BitField;
  ULONG     fPointer : 2;
  ULONG     fArray : 1;
  ULONG     fStruct : 1;
  ULONG     fConstant : 1;
  ULONG     fStatic : 1;
  ULONG     Reserved : 26;
} FIELD_INFO, *PFIELD_INFO;

メンバーズ

fName

この構造体が適用されるシンボルのメンバーの名前を指定します。 サブメンバーは、区切り記号 "を使用して指定できます。" と "->" です。 fOptionsでDBG_DUMP_FIELD_FULL_NAMEが設定されていない限り、fName メンバー名の先頭と見なされます。

printName

メンバーの名前を印刷するときに使用する代替名を指定します。 printName NULL 場合、メンバーの名前を印刷するときにメンバーの実際の名前が使用されます。

size

fName で指定されたメンバーの、ターゲットのメモリ内のサイズバイト単位で受け取ります。

メンバーが配列の場合、サイズ 配列内の要素の数を指定します。

fOptions

IG_DUMP_SYMBOL_INFO Ioctl 操作の動作を決定するフラグを指定します。 これらのフラグの詳細については、DBG_DUMP_FIELD_XXXを参照してください。

address

fName で指定されたメンバーのターゲットメモリ内アドレスを受け取ります。 SYM_DUMP_PARAMのシンボルの種類にアドレスが指定されていない場合。addr、アドレス、型のインスタンスの先頭からの相対メンバーのオフセットを受け取ります。 SYM_DUMP_PARAMの詳細については、IG_DUMP_SYMBOL_INFOを参照してください。

fieldCallBack

fName で指定されたメンバーに関する情報を使用して呼び出される PSYM_DUMP_FIELD_CALLBACK コールバック関数指定します。 コールバック関数には、フィールド情報とSYM_DUMP_PARAMの値を含む構造体が渡されます。コンテキストをします。

fOptions 、fieldCallBack が NULL 、または ioctl に渡されるSYM_DUMP_PARAM構造体の Options メンバーにDBG_DUMP_CALL_FOR_EACHが設定されていない場合、 DBG_DUMP_FIELD_NO_CALLBACK_REQがに設定されている場合は、コールバック関数は呼び出されません。 DBG_DUMP_FIELD_COPY_FIELD_DATAが fOptions 設定されている場合、fieldCallBack 使用されません。

pBuffer

fName で指定されたメンバーの値受け取るバッファーを指定します。 このメンバーは、fOptions でDBG_DUMP_FIELD_COPY_FIELD_DATAが設定場合にのみ使用されます。

TypeId

fName で指定されたメンバーの型識別子を受け取ります。

FieldOffset

構造体内のメンバーのオフセットを受け取ります。

BufferSize

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

BitField

構造体のビット フィールドに関する情報を受け取ります。

BitField.Position

ビット フィールドの開始位置を受け取ります。 これは、構造体の先頭からビット フィールドまでのビット数です。

BitField.Size

ビット フィールドのサイズをビット単位で受け取ります。

_BitField

構造体のビット フィールドに関する情報を受け取ります。

fPointer

メンバーがポインターであるかどうかを示すブール値を受け取ります。 メンバーがポインターでない場合、fPointer は FALSE 。 メンバーが 32 ビット ポインターの場合は 1、メンバーが 64 ビット ポインターの場合は 3 です。

fArray

メンバーが配列であるかどうかを示すブール値を受け取ります。 フィールドが配列でない場合は fArray が FALSE され、true が されます。

fStruct

メンバーが構造体であるかどうかを示すブール値を受け取ります。 fStruct は、メンバーが構造体でない場合は FALSE され、存在する場合は TRUE 。

fConstant

メンバーが定数であるかどうかを示すブール値を受け取ります。 メンバーが定数でない場合は fConstant が FALSE 、TRUE されます。

fStatic

Reserved

備考

IG_DUMP_SYMBOL_INFOIoctl 操作を呼び出すときは、この構造体の fName メンバーに、この構造体が適用されるシンボルのメンバーの名前を設定し、fOptions メンバーに操作の目的の機能を反映させる必要があります。 その他のメンバーは省略可能であるか、ioctl によって入力されます。

必要条件

要件 価値
ヘッダー wdbgexts.h

関連項目

DBG_DUMP_FIELD_XXX

IG_DUMP_SYMBOL_INFO

Ioctl を する

PSYM_DUMP_FIELD_CALLBACK