IDkmDebugMonitorExceptionNotification Interface

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.ComponentInterfaces
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll

IDkmDebugMonitorExceptionNotification is implemented by components that want to listen for the DebugMonitorException event. When this notification fires, the target process will be suspended and can be examined. The 'DebugMonitorException' event provides notification from debug monitors about exceptions which occur within the target process. This event notification is consumed by the exception manager, and by debug monitors operating at component levels above the debug monitor which detected the exception. Higher level components should use exception triggers instead. See DkmExceptionTrigger for more information.

If the exception is sent unhandled (DkmExceptionProcessingStage.Unhandled is set) then the IDE will stop. Other exceptions may stop depending on any DkmExceptionTriggers set by the AD7 AL or other components. The AD7 AL reads the default set of triggers from %VSRegistryRoot%\AD7Metrics\Exception%CategoryGuid%*.

DebugMonitorException events can be suppressed by calling DkmEventDescriptorS.Suppress().

Implementations of this interface may restrict when they are called using a filter defined in their component configuration. The following properties may be used: BaseDebugMonitorId, EngineId, ExceptionCategory, RuntimeId.

public interface class IDkmDebugMonitorExceptionNotification
public interface class IDkmDebugMonitorExceptionNotification
__interface IDkmDebugMonitorExceptionNotification
public interface IDkmDebugMonitorExceptionNotification
type IDkmDebugMonitorExceptionNotification = interface
Public Interface IDkmDebugMonitorExceptionNotification

Methods

OnDebugMonitorException(DkmExceptionInformation, DkmWorkList, DkmEventDescriptorS)

OnDebugMonitorException is invoked as part of event processing. See interface definition for more information.

Applies to