FIELD_INFO estrutura (wdbgexts.h)
A estrutura FIELD_INFO é usada pela operaçãoIG_DUMP_SYMBOL_INFO 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. 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, tamanho especifica o número de elementos na matriz.
fOptions
Especifica os sinalizadores que determinam o comportamento da operação de 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.do suplemento, endereço 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 uma função de retorno de chamada PSYM_DUMP_FIELD_CALLBACK a ser chamada com as informações sobre o membro especificadas por fName. A função de retorno de chamada é passada por uma estrutura com as informações de campo e o valor de SYM_DUMP_PARAM.de contexto.
Nenhuma função de retorno de chamada será chamada se DBG_DUMP_FIELD_NO_CALLBACK_REQ estiver definida em fOptions, fieldCallBack for NULL ou o membro opções 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 de do 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 do 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 verdadeiro 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 VERDADEIRO 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 VERDADEIRO se for.
fStatic
Reserved
Observações
Ao chamar a operação deIG_DUMP_SYMBOL_INFO Ioctl, o fName membro 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 por Ioctl.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | wdbgexts.h |