| Debugging Tools for Windows |
The DBG_DUMP_FIELD_XXX bit flags are used by the fOptions member of the FIELD_INFO structure to control the behavior of the IG_DUMP_SYMBOL_INFO Ioctl operation.
The following flags can be present.
| Flag | Effect |
|---|---|
| DBG_DUMP_FIELD_CALL_BEFORE_PRINT | The callback function is called before printing the member. |
| DBG_DUMP_FIELD_NO_CALLBACK_REQ | No callback function is called. |
| DBG_DUMP_FIELD_RECUR_ON_THIS | Submembers of the member are processed. |
| DBG_DUMP_FIELD_FULL_NAME | fName must match completely, as opposed to just having a matching prefix, for the member to be processed. |
| DBG_DUMP_FIELD_ARRAY | Print array elements of an array member. |
| DBG_DUMP_FIELD_COPY_FIELD_DATA | The value of the member is copied into pBuffer. |
| DBG_DUMP_FIELD_RETURN_ADDRESS | During a callback or when Ioctl returns, the FIELD_INFO.address member contains the address of the symbol's member. If no address is supplied for the type, FIELD_INFO.address contains total offset of the member from the beginning of the type. |
| DBG_DUMP_FIELD_SIZE_IN_BITS | For a bit field, return the offset and size in bits instead of bytes. |
| DBG_DUMP_FIELD_NO_PRINT | Do not print this member (only callback function are called and data copies are performed). |
| DBG_DUMP_FIELD_DEFAULT_STRING DBG_DUMP_FIELD_WCHAR_STRING DBG_DUMP_FIELD_MULTI_STRING DBG_DUMP_FIELD_GUID_STRING | If the member is a pointer, it is printed as a string, ANSI string , WCHAR string, MULTI string, or GUID. |
In addition, the result of the macro DBG_DUMP_RECUR_LEVEL(Level) can be added to the bit-set to specify how deep into structures to recurse. Level can be a number between 0 and 15.
Headers: Defined in wdbgexts.h. If you are writing a WdbgExts extension, include wdbgexts.h. If you are writing a DbgEng extension that uses these constants, include wdbgexts.h before dbgeng.h (see Writing DbgEng Extension Code for details).