FIELD_INFO结构(wdbgexts.h)

IG_DUMP_SYMBOL_INFOIoctl作使用 FIELD_INFO 结构来提供有关结构中的成员的信息。

语法

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

指定此结构应用于的符号成员的名称。 可以使用分隔符“指定子member。“和”->”。 除非在 fOptions中设置DBG_DUMP_FIELD_FULL_NAME,否则 fName 被视为成员名称的开头。

printName

指定打印成员名称时要使用的可选名称。 如果 printNameNULL,则打印成员的名称时将使用成员的实际名称。

size

接收由 fName指定的成员的内存大小(以字节为单位)。

如果成员是数组,则 大小 指定数组中的元素数。

fOptions

指定确定IG_DUMP_SYMBOL_INFO Ioctl作行为的标志。 有关这些标志的说明,请参阅 DBG_DUMP_FIELD_XXX

address

接收目标内存中由 fName指定的成员的地址。 如果未为SYM_DUMP_PARAM中的符号类型提供地址。添加器地址 接收成员相对于类型实例开头的偏移量。 有关SYM_DUMP_PARAM的详细信息,请参阅 IG_DUMP_SYMBOL_INFO

fieldCallBack

指定一个 PSYM_DUMP_FIELD_CALLBACK 回调函数,该函数包含由 fName指定的成员的相关信息。 回调函数将传递一个结构,其中包含字段信息和SYM_DUMP_PARAM的值。上下文

如果在 fOptions中设置了DBG_DUMP_FIELD_NO_CALLBACK_REQ,则不会调用回调函数,fieldCallBackNULL,或者传递给 Ioctl 的SYM_DUMP_PARAM结构的 选项 成员没有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

接收一个布尔值,该值指示成员是否为指针。 如果成员不是指针,fPointerFALSE。 如果成员是 32 位指针,则为 1;如果成员是 64 位指针,则为 3。

fArray

接收一个布尔值,该值指示成员是否为数组。 如果字段不是数组,则 fArrayFALSE;如果字段不是数组,则 为 TRUE(如果为该字段)。

fStruct

接收一个布尔值,该值指示成员是否为结构。 如果成员不是结构,则 fStructFALSE;如果成员不是结构,TRUE

fConstant

接收一个布尔值,该值指示成员是否为常量。 如果成员不是常量,fConstantFALSE;如果成员不是常量,则为 true 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