|
Version: 1.0.3
Updated: 10.02.2005
MiniDump Wizard application allows to experiment with MiniDumpWriteDump and MiniDumpCallback
functions without writing code. It is possible to specify a combination of MINIDUMP_TYPE
flags that will be passed to MiniDumpWriteDump function, and it is possible to respond
to MiniDumpCallback calls in a series of dialogs.
See this article for more information
about minidump creation options, including MINIDUMP_TYPE flags and MiniDumpCallback function.
How to use MiniDump Wizard
When you start MiniDump Wizard, it shows a dialog window that allows to select
MINIDUMP_TYPE flags that will be passed to MiniDumpWriteDump function. In the same
dialog, you can specify the callback types that you want to respond to.
The dialog also allows to specify the target process. You can specify the process
identifier (pid) of the target, or you can create the minidump for MiniDump Wizard
process itself. In order to explore the contents of minidumps created for
MiniDump Wizard process, MiniDumpWiz.pdb file is provided.
After you have specified all settings in the first dialog, pressing Next will
either create the minidump (if no callback options have been selected), or will
show the dialog pages for the specified calls to MiniDumpCallback function,
where you can inspect the data passed to the callback and respond to the callback
call (by using the dialog controls to modify the callback's return value,
the contents of MINIDUMP_CALLBACK_OUTPUT structure, or both).
The minidump file will be called MiniDumpWiz.dmp. Currently there is no way
to change its name (this is to keep the application as simple as possible).
Download
MiniDump Wizard depends on DbgHelp.dll (DbgHelp.dll 6.3.17.0 or newer is required).
The DLL must be in the same directory as MiniDump Wizard executable.
You can download the DLL with MiniDump Wizard, or you also can download MiniDump Wizard
only and obtain DbgHelp.dll from another source (the latest version of DbgHelp.dll
is usually supplied with Debugging
Tools for Windows).
Download MiniDump Wizard (DbgHelp.dll included) (977 Kb)
Download MiniDump Wizard (DbgHelp.dll is not included) (566 Kb)
MiniDump Wizard dialog pages
Main page
This page is always shown when you start MiniDump Wizard.
"Target process" group allows to specify the target process. You can specify the decimal process id (PID)
of the target process, or you can select "MiniDump Wizard itself" option to dump the MiniDump Wizard
process (an artificial exception will be raised in the latter case).
"Show callbacks" group allows to select the callback types that should be handled.
"MINIDUMP_TYPE flags" group allows to specify MINIDUMP_TYPE flags that will be passed
to MiniDumpWriteDump function.
CancelCallback page
This page is shown when MiniDumpCallback function is called with CancelCallback
callback type.
"Response" group allows to set or change the values of Cancel and CheckCancel
members of MINIDUMP_CALLBACK_OUTPUT structure.
"Callback return value" group allows to specify the return value of the callback function.
IncludeThreadCallback page
This page is shown when MiniDumpCallback function is called with IncludeThreadCallback
callback type.
"Thread information" group displays the contents of MINIDUMP_INCLUDE_THREAD_CALLBACK
structure.
"Callback return value" group allows to specify the return value of the callback function.
IncludeModuleCallback page
This page is shown when MiniDumpCallback function is called with IncludeModuleCallback
callback type.
"Module information" group displays the contents of MINIDUMP_INCLUDE_MODULE_CALLBACK
structure.
"Callback return value" group allows to specify the return value of the callback function.
ModuleCallback page
This page is shown when MiniDumpCallback function is called with ModuleCallback
callback type.
"Module information" group displays the contents of MINIDUMP_MODULE_CALLBACK
structure.
"Module write flags" group allows to set or clear the flags in ModuleWriteFlags
member of MINIDUMP_CALLBACK_OUTPUT structure.
"Callback return value" group allows to specify the return value of the callback function.
ThreadCallback page
This page is shown when MiniDumpCallback function is called with ThreadCallback
callback type.
"Thread information" group displays the contents of MINIDUMP_MODULE_CALLBACK
structure.
"Thread write flags" group allows to set or clear the flags in ThreadWriteFlags
member of MINIDUMP_CALLBACK_OUTPUT structure.
"Callback return value" group allows to specify the return value of the callback function.
MemoryCallback page
This page is shown when MiniDumpCallback function is called with MemoryCallback
callback type.
"Include memory range" group allows to specify the base address and size of the memory
range whose contents should be included into the minidump. Both numbers must be hexadecimal,
without prefix.
"Callback return value" group allows to specify the return value of the callback function.
|