debug-filter-xxx.md

title	description	ms.date	keywords	topic_type	ms.topic	api_name	api_location	api_type
DEBUG_FILTER_XXX	DEBUG\_FILTER\_XXX	12/07/2017	DEBUG_FILTER_XXX Windows Debugging	apiref	reference	DEBUG_FILTER_XXX	DbgEng.h	HeaderDef

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

Header

DbgEng.h (include DbgEng.h)