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 |