FIELD_INFO struttura (wdbgexts.h)
La struttura FIELD_INFO viene utilizzata dall'operazione Ioctldi IG_DUMP_SYMBOL_INFO per fornire informazioni su un membro in una struttura.
Sintassi
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;
Members
fName
Specifica il nome del membro del simbolo a cui si applica questa struttura. È possibile specificare sottoscrizioni usando i delimitatori "." e "->". A meno che DBG_DUMP_FIELD_FULL_NAME sia impostato in fOptions, fName viene considerato come l'inizio del nome del membro.
printName
Specifica un nome alternativo da usare quando si stampa il nome del membro. Se printName è NULL, il nome effettivo del membro viene usato quando si stampa il nome del membro.
size
Riceve le dimensioni nella memoria della destinazione, in byte, del membro specificato da fName.
Se il membro è una matrice, le dimensioni specificano il numero di elementi nella matrice.
fOptions
Specifica i flag che determinano il comportamento dell'operazione Ioctl IG_DUMP_SYMBOL_INFO. Per una descrizione di questi flag, vedere DBG_DUMP_FIELD_XXX.
address
Riceve l'indirizzo nella memoria del membro di destinazione specificato da fName. Se non viene fornito alcun indirizzo per il tipo di simbolo in SYM_DUMP_PARAM. addr, indirizzo riceve l'offset del membro rispetto all'inizio di un'istanza del tipo. Per altre informazioni sulle SYM_DUMP_PARAM, vedere IG_DUMP_SYMBOL_INFO.
fieldCallBack
Specifica una funzione di callback PSYM_DUMP_FIELD_CALLBACK da chiamare con le informazioni sul membro specificato da fName. La funzione di callback viene passata una struttura con le informazioni sul campo e il valore di SYM_DUMP_PARAM. contesto.
Nessuna funzione di callback viene chiamata se DBG_DUMP_FIELD_NO_CALLBACK_REQ è impostata in fOptions, fieldCallBack è NULL o il membro Opzioni della struttura SYM_DUMP_PARAM passata a Ioctl non ha DBG_DUMP_CALL_FOR_EACH impostato. Se DBG_DUMP_FIELD_COPY_FIELD_DATA è impostato in fOptions, fieldCallBack non viene usato.
pBuffer
Specifica un buffer per ricevere il valore del membro specificato da fName. Questo membro viene usato solo se DBG_DUMP_FIELD_COPY_FIELD_DATA è impostato in fOptions.
TypeId
Riceve l'identificatore per il tipo del membro specificato da fName.
FieldOffset
Riceve l'offset del membro all'interno della struttura.
BufferSize
Specifica le dimensioni, in byte, del buffer pBuffer .
BitField
Riceve informazioni sui campi bit in una struttura.
BitField.Position
Riceve la posizione iniziale del campo bit. Si tratta del numero di bit dall'inizio della struttura al campo bit.
BitField.Size
Riceve le dimensioni, in bit, del campo bit.
_BitField
Riceve informazioni sui campi bit in una struttura.
fPointer
Riceve un valore booleano che indica se il membro è un puntatore. fPointer è FALSE se il membro non è un puntatore. È 1 se il membro è un puntatore a 32 bit e 3 se il membro è un puntatore a 64 bit.
fArray
Riceve un valore booleano che indica se il membro è una matrice. fArray è FALSE se il campo non è una matrice e TRUE se è.
fStruct
Riceve un valore booleano che indica se il membro è una struttura. fStruct è FALSE se il membro non è una struttura e TRUE se è.
fConstant
Riceve un valore booleano che indica se il membro è una costante. fConstant è FALSE se il membro non è una costante e TRUE se è.
fStatic
Reserved
Commenti
Quando si chiama l'operazione IoctlIG_DUMP_SYMBOL_INFO, il membro fName di questa struttura deve essere impostato sul nome del membro del simbolo a cui si applica questa struttura e il membro fOptions deve riflettere la funzionalità desiderata dell'operazione. Gli altri membri sono facoltativi o vengono compilati da Ioctl.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | wdbgexts.h |