estructura FIELD_INFO (wdbgexts.h)
La FIELD_INFO estructura se usa en la operación IG_DUMP_SYMBOL_INFOIoctl para proporcionar información sobre un miembro de una estructura.
Sintaxis
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;
Miembros
fName
Especifica el nombre del miembro del símbolo al que se aplica esta estructura. Los submembrados se pueden especificar mediante los delimitadores "." y "->". A menos que DBG_DUMP_FIELD_FULL_NAME se establezca en fOptions, fName se considera el principio del nombre del miembro.
printName
Especifica un nombre alternativo que se usará al imprimir el nombre del miembro. Si printName es NULL, el nombre real del miembro se usa al imprimir el nombre del miembro.
size
Recibe el tamaño de la memoria del destino, en bytes, del miembro especificado por fName.
Si el miembro es una matriz, size especifica el número de elementos de la matriz.
fOptions
Especifica las marcas que determinan el comportamiento de la operación de IG_DUMP_SYMBOL_INFO Ioctl . Para obtener una descripción de estas marcas, consulte DBG_DUMP_FIELD_XXX.
address
Recibe la dirección en la memoria del destino del miembro especificado por fName. Si no se proporciona ninguna dirección para el tipo de símbolo en SYM_DUMP_PARAM. addr, address recibe el desplazamiento del miembro con respecto al principio de una instancia del tipo. Para obtener más información sobre SYM_DUMP_PARAM, consulte IG_DUMP_SYMBOL_INFO.
fieldCallBack
Especifica un PSYM_DUMP_FIELD_CALLBACK función de devolución de llamada a la que se llamará con la información sobre el miembro especificado por fName. La función de devolución de llamada se pasa a una estructura con la información de campo y el valor de SYM_DUMP_PARAM. context.
No se llama a ninguna función de devolución de llamada si DBG_DUMP_FIELD_NO_CALLBACK_REQ se establece en fOptions, fieldCallBack es NULL o el miembro Options de la estructura de SYM_DUMP_PARAM que se pasa a Ioctl no tiene DBG_DUMP_CALL_FOR_EACH establecido. Si DBG_DUMP_FIELD_COPY_FIELD_DATA se establece en fOptions, no se usa fieldCallBack .
pBuffer
Especifica un búfer para recibir el valor del miembro especificado por fName. Este miembro solo se usa si DBG_DUMP_FIELD_COPY_FIELD_DATA se establece en fOptions.
TypeId
Recibe el identificador del tipo del miembro especificado por fName.
FieldOffset
Recibe el desplazamiento del miembro dentro de la estructura.
BufferSize
Especifica el tamaño, en bytes, del búfer de pBuffer .
BitField
Recibe información sobre los campos de bits de una estructura.
BitField.Position
Recibe la posición inicial del campo de bits. Este es el número de bits del principio de la estructura al campo de bits.
BitField.Size
Recibe el tamaño, en bits, del campo de bits.
_BitField
Recibe información sobre los campos de bits de una estructura.
fPointer
Recibe un valor booleano que indica si el miembro es un puntero. fPointer es FALSE si el miembro no es un puntero. Es 1 si el miembro es un puntero de 32 bits y 3 si el miembro es un puntero de 64 bits.
fArray
Recibe un valor booleano que indica si el miembro es una matriz. fArray es FALSE si el campo no es una matriz y TRUE si es.
fStruct
Recibe un valor booleano que indica si el miembro es una estructura. fStruct es FALSE si el miembro no es una estructura y TRUE si es.
fConstant
Recibe un valor booleano que indica si el miembro es una constante. fConstant es FALSE si el miembro no es una constante y TRUE si es.
fStatic
Reserved
Comentarios
Al llamar a la operación IG_DUMP_SYMBOL_INFOIoctl , el miembro fName de esta estructura debe establecerse en el nombre del miembro del símbolo al que se aplica esta estructura y el miembro fOptions debe reflejar la funcionalidad deseada de la operación. Los demás miembros son opcionales o se rellenan mediante Ioctl.
Requisitos
Requisito | Valor |
---|---|
Header | wdbgexts.h |