Debugging Tools for Windows

DEBUG_FILTER_XXX

The DEBUG_FILTER_XXX constants are used for three different purposes: to specify individual specific event filters, to specify the break status of an event filter, and to specify the handling status of an exception filter.

Specific Event Filter

The following constants are used to specify specific event filters.

Value Event
DEBUG_FILTER_CREATE_THREAD Create Thread
DEBUG_FILTER_EXIT_THREAD Exit Thread
DEBUG_FILTER_CREATE_PROCESS Create Process
DEBUG_FILTER_EXIT_PROCESS Exit Process
DEBUG_FILTER_LOAD_MODULE Load Module
DEBUG_FILTER_UNLOAD_MODULE Unload Module
DEBUG_FILTER_SYSTEM_ERROR System Error
DEBUG_FILTER_INITIAL_BREAKPOINT Initial Break Point
DEBUG_FILTER_INITIAL_MODULE_LOAD Initial Module Load
DEBUG_FILTER_DEBUGGEE_OUTPUT Target Output

Break Status

The following constants are used to specify the break status of an event filter.

Value Description
DEBUG_FILTER_BREAK The event will break into the debugger.
DEBUG_FILTER_SECOND_CHANCE_BREAK The event will break into the debugger if it is a second chance exception.
DEBUG_FILTER_OUTPUT A notification of the event will be printed to the debugger console.
DEBUG_FILTER_IGNORE The event is ignored.

Additionally, for an arbitrary exception filter, setting the break status to DEBUG_FILTER_REMOVE, removes the event filter.

Handling Status

The following constants are used to specify the handling status of an exception filter.

Value Description
DEBUG_FILTER_GO_HANDLED The exception has been handled.
DEBUG_FILTER_GO_NOT_HANDLED The exception has not been handled.

Requirements

Headers: Defined in DbgEng.h. Include DbgEng.h.

Build machine: CAPEBUILD