FIELD_INFO 構造体 (wdbgexts.h)

[アーティクル]
02/29/2024

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

構文

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 で指定されたメンバーのターゲットのメモリ内のサイズをバイト単位で受け取ります。

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

fOptions

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

address

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

fieldCallBack

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

fOptions でDBG_DUMP_FIELD_NO_CALLBACK_REQが設定されている場合、fieldCallBack が NULL の場合、または Ioctl に渡されるSYM_DUMP_PARAM構造体の Options メンバーにDBG_DUMP_CALL_FOR_EACHが設定されていない場合、コールバック関数は呼び出されません。 fOptions でDBG_DUMP_FIELD_COPY_FIELD_DATAが設定されている場合、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_INFO Ioctl 操作を呼び出すときは、この構造体の fName メンバーに、この構造体が適用されるシンボルのメンバーの名前を設定し、fOptions メンバーに操作の目的の機能を反映させる必要があります。他のメンバーは省略可能であるか、 Ioctl によって入力されます。