estrutura FIELD_INFO (wdbgexts.h)

Artigo
03/05/2024

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.