estrutura FIELD_INFO (wdbgexts.h)
A estrutura FIELD_INFO é usada pela IG_DUMP_SYMBOL_INFO operação Ioctl para fornecer informações sobre um membro em uma estrutura.
Sintaxe
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;
Membros
fName
Especifica o nome do membro do símbolo ao qual essa estrutura se aplica. Os submembros podem ser especificados usando os delimitadores "." e "->". A menos que DBG_DUMP_FIELD_FULL_NAME seja definido em fOptions, fName é considerado o início do nome do membro.
printName
Especifica um nome alternativo a ser usado ao imprimir o nome do membro. Se printName for NULL, o nome real do membro será usado ao imprimir o nome do membro.
size
Recebe o tamanho na memória do destino, em bytes, do membro especificado por fName.
Se o membro for uma matriz, size especificará o número de elementos na matriz.
fOptions
Especifica os sinalizadores que determinam o comportamento da operação IG_DUMP_SYMBOL_INFO Ioctl . Para obter uma descrição desses sinalizadores, consulte DBG_DUMP_FIELD_XXX.
address
Recebe o endereço na memória do destino do membro especificado por fName. Se nenhum endereço for fornecido para o tipo de símbolo no SYM_DUMP_PARAM. addr, address recebe o deslocamento do membro em relação ao início de uma instância do tipo. Para obter mais informações sobre SYM_DUMP_PARAM, consulte IG_DUMP_SYMBOL_INFO.
fieldCallBack
Especifica um PSYM_DUMP_FIELD_CALLBACK função de retorno de chamada a ser chamada com as informações sobre o membro especificado por fName. A função de retorno de chamada recebe uma estrutura com as informações de campo e o valor de SYM_DUMP_PARAM. contexto.
Nenhuma função de retorno de chamada será chamada se DBG_DUMP_FIELD_NO_CALLBACK_REQ estiver definido em fOptions, fieldCallBack for NULL ou o membro Options da estrutura SYM_DUMP_PARAM passada para Ioctl não tiver DBG_DUMP_CALL_FOR_EACH definido. Se DBG_DUMP_FIELD_COPY_FIELD_DATA estiver definido em fOptions, fieldCallBack não será usado.
pBuffer
Especifica um buffer para receber o valor do membro especificado por fName. Esse membro só será usado se DBG_DUMP_FIELD_COPY_FIELD_DATA estiver definido em fOptions.
TypeId
Recebe o identificador para o tipo do membro especificado por fName.
FieldOffset
Recebe o deslocamento do membro dentro da estrutura .
BufferSize
Especifica o tamanho, em bytes, do buffer pBuffer .
BitField
Recebe informações sobre campos de bits em uma estrutura.
BitField.Position
Recebe a posição inicial do campo de bits. Esse é o número de bits de até o início da estrutura para o campo de bits.
BitField.Size
Recebe o tamanho, em bits, do campo de bits.
_BitField
Recebe informações sobre campos de bits em uma estrutura.
fPointer
Recebe um valor booliano que indica se o membro é um ponteiro. fPointer será FALSE se o membro não for um ponteiro. Será 1 se o membro for um ponteiro de 32 bits e 3 se o membro for um ponteiro de 64 bits.
fArray
Recebe um valor booliano que indica se o membro é uma matriz. fArray será FALSE se o campo não for uma matriz e TRUE se for.
fStruct
Recebe um valor booliano que indica se o membro é uma estrutura. FStruct será FALSE se o membro não for uma estrutura e TRUE se for.
fConstant
Recebe um valor booliano que indica se o membro é uma constante. fConstant será FALSE se o membro não for uma constante e TRUE se for.
fStatic
Reserved
Comentários
Ao chamar o IG_DUMP_SYMBOL_INFO operação Ioctl, o membro fName dessa estrutura deve ser definido como o nome do membro do símbolo ao qual essa estrutura se aplica e o membro fOptions deve refletir a funcionalidade desejada da operação. Os outros membros são opcionais ou são preenchidos pelo Ioctl.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | wdbgexts.h |