MiniDumpWriteDump Reference

The MiniDumpWriteDump function writes user-mode minidump information to the specified file. MiniDumpWriteDump enables you to get a user-mode crash dump of a failing process. This allows you to debug the issue after it happens (in cases where a debugger is not connected), enabling automated testing scenarios.

See also MiniDumpWriteDump Overview.

Functions

Name Description
MiniDumpCallback An application-defined callback function used with MiniDumpWriteDump. It receives extended minidump information.
MiniDumpWriteDump Writes user-mode minidump information to the specified file.

Structures

Name Description
CPU_INFORMATION Processor-specific information.
MINIDUMP_CALLBACK_INPUT Contains information used by the MiniDumpCallback function.
MINIDUMP_CALLBACK_OUTPUT Contains information returned by the MiniDumpCallback function.
MINIDUMP_DIRECTORY Contains the information needed to access a specific data stream in a minidump file.
MINIDUMP_EXCEPTION Contains exception information.
MINIDUMP_EXCEPTION_INFORMATION Contains the exception information written to the minidump file by the MiniDumpWriteDump function.
MINIDUMP_EXCEPTION_INFORMATION64 Contains the exception information written to the minidump file by the MiniDumpWriteDump function.
MINIDUMP_EXCEPTION_STREAM Represents an exception information stream.
MINIDUMP_FUNCTION_TABLE_DESCRIPTOR Represents a function table stream.
MINIDUMP_FUNCTION_TABLE_STREAM Represents the header for the function table stream.
MINIDUMP_HANDLE_DATA_STREAM Represents the header for a handle data stream.
MINIDUMP_HANDLE_DESCRIPTOR Contains the state of an individual system handle at the time the minidump was written.
MINIDUMP_HANDLE_DESCRIPTOR_2 Describes the state of an individual system handle at the time the minidump was written.
MINIDUMP_HANDLE_OBJECT_INFORMATION Contains object-specific information for a handle.
MINIDUMP_HANDLE_OPERATION_LIST Contains a list of handle operations.
MINIDUMP_HEADER Contains header information for the minidump file.
MINIDUMP_INCLUDE_MODULE_CALLBACK Contains information for the MiniDumpCallback function when the callback type is IncludeModuleCallback.
MINIDUMP_INCLUDE_THREAD_CALLBACK Contains information for the MiniDumpCallback function when the callback type is IncludeThreadCallback.
MINIDUMP_IO_CALLBACK Contains I/O callback information. This structure is used by the MiniDumpCallback function when the callback type is IoStartCallback, IoWriteAllCallback, or IoFinishCallback.
MINIDUMP_LOCATION_DESCRIPTOR Contains information describing the location of a data stream within a minidump file.
MINIDUMP_MEMORY_DESCRIPTOR Describes a range of memory.
MINIDUMP_MEMORY_INFO Describes a region of memory.
MINIDUMP_MEMORY_INFO_LIST Contains a list of memory regions.
MINIDUMP_MEMORY_LIST Contains a list of memory ranges.
MINIDUMP_MISC_INFO Contains a variety of information.
MINIDUMP_MISC_INFO_2 Represents information in the miscellaneous information stream.
MINIDUMP_MISC_INFO_3 Represents information in the miscellaneous information stream.
MINIDUMP_MISC_INFO_4 Represents information in the miscellaneous information stream.
MINIDUMP_MODULE Contains information for a specific module.
MINIDUMP_MODULE_CALLBACK Contains module information for the MiniDumpCallback function when the callback type is ModuleCallback.
MINIDUMP_MODULE_LIST Contains a list of modules.
MINIDUMP_READ_MEMORY_FAILURE_CALLBACK Contains information about a failed memory read operation. This structure is used by the MiniDumpCallback function when the callback type is ReadMemoryFailureCallback.
MINIDUMP_STRING Describes a string.
MINIDUMP_SYSTEM_INFO Contains processor and operating system information.
MINIDUMP_THREAD Contains information for a specific thread.
MINIDUMP_THREAD_CALLBACK Contains thread information for the MiniDumpCallback function when the callback type is ThreadCallback.
MINIDUMP_THREAD_EX Contains extended information for a specific thread.
MINIDUMP_THREAD_EX_CALLBACK Contains extended thread information for the MiniDumpCallback function when the callback type is ThreadExCallback.
MINIDUMP_THREAD_EX_LIST Contains a list of threads.
MINIDUMP_THREAD_INFO Contains thread state information.
MINIDUMP_THREAD_INFO_LIST Contains a list of threads.
MINIDUMP_THREAD_LIST Contains a list of threads.
MINIDUMP_UNLOADED_MODULE Contains information about a module that has been unloaded. This information can help diagnose problems calling code that is no longer loaded.
MINIDUMP_UNLOADED_MODULE_LIST Contains a list of unloaded modules.
MINIDUMP_USER_RECORD User record.
MINIDUMP_USER_STREAM Contains user-defined information stored in a data stream.
MINIDUMP_USER_STREAM_INFORMATION Contains a list of user data streams used by the MiniDumpWriteDump function.

Enumerations

Name Description
MINIDUMP_CALLBACK_TYPE Identifies the type of information returned by the MiniDumpCallback function. Not all memory failures will cause a callback; for example if the failure is within a stack then the failure is considered to be unrecoverable and the minidump will fail.
MINIDUMP_HANDLE_OBJECT_INFORMATION_TYPE Identifies the type of object-specific information.
MINIDUMP_SECONDARY_FLAGS Specifies the secondary flags for the minidump.
MINIDUMP_STREAM_TYPE Represents the type of a minidump data stream.
MINIDUMP_TYPE 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.
MODULE_WRITE_FLAGS Identifies the type of module information that will be written to the minidump file by the MiniDumpWriteDump function.
THREAD_WRITE_FLAGS Identifies the type of thread information that will be written to the minidump file by the MiniDumpWriteDump function.

See also

MiniDumpWriteDump Overview