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 submembers 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, se usa el nombre real del miembro al imprimir el nombre del miembro.
size
Recibe el tamaño en la memoria del destino, en bytes, del miembro especificado por fName.
Si el miembro es una matriz, tamaño 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, dirección recibe el desplazamiento del miembro en relación con el 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 va a llamar con la información sobre el miembro especificado por fName. La función de devolución de llamada se pasa una estructura con la información de campo y el valor de SYM_DUMP_PARAM.contexto.
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 pasada a Ioctl no tiene establecido DBG_DUMP_CALL_FOR_EACH. 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 está establecido 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
Observaciones
Al llamar a la operación deIG_DUMP_SYMBOL_INFO Ioctl, el fName miembro 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 |
---|---|
encabezado de | wdbgexts.h |