Edit

Share via

MINIDUMP_TYPE enumeration (minidumpapiset.h)

  • Article

Identifies the type of information that will be written to the minidump file by the MiniDumpWriteDump function.

Important  

The minidump code has evolved greatly over the years since its inception. Many of the constants listed on this page were added later and are not available in all versions of DbgHelp.dll. Those that did not exist in the original code are labeled accordingly along with the version of DbgHelp.dll that they first were implemented in. The listed version numbers corresponds to the Debugging Tools For Windows releases and do not apply to copies of DbgHelp.dll that are integrated into Windows. See DbgHelp Versions for more details.

 

Syntax

typedef enum _MINIDUMP_TYPE {
  MiniDumpNormal = 0x00000000,
  MiniDumpWithDataSegs = 0x00000001,
  MiniDumpWithFullMemory = 0x00000002,
  MiniDumpWithHandleData = 0x00000004,
  MiniDumpFilterMemory = 0x00000008,
  MiniDumpScanMemory = 0x00000010,
  MiniDumpWithUnloadedModules = 0x00000020,
  MiniDumpWithIndirectlyReferencedMemory = 0x00000040,
  MiniDumpFilterModulePaths = 0x00000080,
  MiniDumpWithProcessThreadData = 0x00000100,
  MiniDumpWithPrivateReadWriteMemory = 0x00000200,
  MiniDumpWithoutOptionalData = 0x00000400,
  MiniDumpWithFullMemoryInfo = 0x00000800,
  MiniDumpWithThreadInfo = 0x00001000,
  MiniDumpWithCodeSegs = 0x00002000,
  MiniDumpWithoutAuxiliaryState = 0x00004000,
  MiniDumpWithFullAuxiliaryState = 0x00008000,
  MiniDumpWithPrivateWriteCopyMemory = 0x00010000,
  MiniDumpIgnoreInaccessibleMemory = 0x00020000,
  MiniDumpWithTokenInformation = 0x00040000,
  MiniDumpWithModuleHeaders = 0x00080000,
  MiniDumpFilterTriage = 0x00100000,
  MiniDumpWithAvxXStateContext = 0x00200000,
  MiniDumpWithIptTrace = 0x00400000,
  MiniDumpScanInaccessiblePartialPages = 0x00800000,
  MiniDumpFilterWriteCombinedMemory,
  MiniDumpValidTypeFlags = 0x01ffffff
} MINIDUMP_TYPE;

Constants

 
MiniDumpNormal
Value: 0x00000000
0x00000000. Include just the information necessary to capture stack traces for all existing threads in a process.
MiniDumpWithDataSegs
Value: 0x00000001
0x00000001. Include the data sections from all loaded modules. This results in the inclusion of global variables, which
can make the minidump file significantly larger. For per-module control, use the
ModuleWriteDataSeg enumeration value from
MODULE_WRITE_FLAGS.
MiniDumpWithFullMemory
Value: 0x00000002
0x00000002. Include all accessible memory in the process. The raw memory data is included at the end, so that the
initial structures can be mapped directly without the raw memory information. This option can result in a very
large file.
MiniDumpWithHandleData
Value: 0x00000004
0x00000004. Include high-level information about the operating system handles that are active when the minidump is
made.
MiniDumpFilterMemory
Value: 0x00000008
0x00000008. Stack and backing store memory written to the minidump file should be filtered to remove all but the
pointer values necessary to reconstruct a stack trace.
MiniDumpScanMemory
Value: 0x00000010
0x00000010. Stack and backing store memory should be scanned for pointer references to modules in the module list. If a
module is referenced by stack or backing store memory, the ModuleWriteFlags member of
the MINIDUMP_CALLBACK_OUTPUT structure is
set to ModuleReferencedByMemory.
MiniDumpWithUnloadedModules
Value: 0x00000020
0x00000020. Include information from the list of modules that were recently unloaded, if this information is maintained
by the operating system.


Windows Server 2003 and Windows XP:  The operating system does not maintain information for unloaded modules until
Windows Server 2003 with SP1 and Windows XP with SP2.

DbgHelp 5.1:  This value is not supported.
MiniDumpWithIndirectlyReferencedMemory
Value: 0x00000040
0x00000040. Include pages with data referenced by locals or other stack memory. This option can increase the size of
the minidump file significantly.


DbgHelp 5.1:  This value is not supported.
MiniDumpFilterModulePaths
Value: 0x00000080
0x00000080. Filter module paths for information such as user names or important directories. This option may prevent
the system from locating the image file and should be used only in special situations.


DbgHelp 5.1:  This value is not supported.
MiniDumpWithProcessThreadData
Value: 0x00000100
0x00000100. Include complete per-process and per-thread information from the operating system.


DbgHelp 5.1:  This value is not supported.
MiniDumpWithPrivateReadWriteMemory
Value: 0x00000200
0x00000200. Scan the virtual address space for PAGE_READWRITE memory to be included.


DbgHelp 5.1:  This value is not supported.
MiniDumpWithoutOptionalData
Value: 0x00000400
0x00000400. Reduce the data that is dumped by eliminating memory regions that are not essential to meet criteria
specified for the dump. This can avoid dumping memory that may contain data that is private to the user.
However, it is not a guarantee that no private information will be present.


DbgHelp 6.1 and earlier:  This value is not supported.
MiniDumpWithFullMemoryInfo
Value: 0x00000800
0x00000800. Include memory region information. For more information, see
MINIDUMP_MEMORY_INFO_LIST.


DbgHelp 6.1 and earlier:  This value is not supported.
MiniDumpWithThreadInfo
Value: 0x00001000
0x00001000. Include thread state information. For more information, see
MINIDUMP_THREAD_INFO_LIST.


DbgHelp 6.1 and earlier:  This value is not supported.
MiniDumpWithCodeSegs
Value: 0x00002000
0x00002000. Include all code and code-related sections from loaded modules to capture executable content. For
per-module control, use the ModuleWriteCodeSegs enumeration value from
MODULE_WRITE_FLAGS.


DbgHelp 6.1 and earlier:  This value is not supported.
MiniDumpWithoutAuxiliaryState
Value: 0x00004000
0x00004000. Turns off secondary auxiliary-supported memory gathering.
MiniDumpWithFullAuxiliaryState
Value: 0x00008000
0x00008000. Requests that auxiliary data providers include their state in the dump image; the state data that is
included is provider dependent. This option can result in a large dump image.
MiniDumpWithPrivateWriteCopyMemory
Value: 0x00010000
0x00010000. Scans the virtual address space for PAGE_WRITECOPY memory to be included.


Prior to DbgHelp 6.1:  This value is not supported.
MiniDumpIgnoreInaccessibleMemory
Value: 0x00020000
0x00020000. If you specify MiniDumpWithFullMemory, the
MiniDumpWriteDump function will fail if the
function cannot read the memory regions; however, if you include
MiniDumpIgnoreInaccessibleMemory, the
MiniDumpWriteDump function will ignore the memory
read failures and continue to generate the dump. Note that the inaccessible memory regions are not included in
the dump.

Prior to DbgHelp 6.1:  This value is not supported.
MiniDumpWithTokenInformation
Value: 0x00040000
0x00040000. Adds security token related data. This will make the "!token" extension work when
processing a user-mode dump.


Prior to DbgHelp 6.1:  This value is not supported.
MiniDumpWithModuleHeaders
Value: 0x00080000
0x00080000. Adds module header related data.


Prior to DbgHelp 6.1:  This value is not supported.
MiniDumpFilterTriage
Value: 0x00100000
0x00100000. Adds filter triage related data.


Prior to DbgHelp 6.1:  This value is not supported.
MiniDumpWithAvxXStateContext
Value: 0x00200000
0x00200000. Adds AVX crash state context registers.

Prior to DbgHelp 6.1:  This value is not supported.
MiniDumpWithIptTrace
Value: 0x00400000
0x00400000. Adds Intel Processor Trace related data.

Prior to DbgHelp 6.1:  This value is not supported.
MiniDumpScanInaccessiblePartialPages
Value: 0x00800000
0x00800000. Scans inaccessible partial memory pages.

Prior to DbgHelp 6.1:  This value is not supported.
MiniDumpValidTypeFlags
Value: 0x01ffffff
0x00ffffff. Indicates which flags are valid.

Requirements

Requirement Value
Header minidumpapiset.h (include DbgHelp.h)
Redistributable DbgHelp.dll 5.1 or later

See also

MiniDumpWriteDump