DkmLoadCompleteEventDeferral Class

Definition

Object created by runtime debug monitors in order to defer the sending of the LoadComplete event. This is important in attach scenario as load complete is used to indicate that process attach has finished and that all breakpoints in running code have been bound.

This API was introduced in Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2).

public ref class DkmLoadCompleteEventDeferral
[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmLoadCompleteEventDeferral
[Windows::Foundation::Metadata::WebHostHidden]
class DkmLoadCompleteEventDeferral
[System.Runtime.InteropServices.Guid("5e4f3517-4169-c1bf-6f13-0b84105f8c58")]
public class DkmLoadCompleteEventDeferral
[<System.Runtime.InteropServices.Guid("5e4f3517-4169-c1bf-6f13-0b84105f8c58")>]
type DkmLoadCompleteEventDeferral = class
Public Class DkmLoadCompleteEventDeferral
Inheritance
DkmLoadCompleteEventDeferral
Attributes

Properties

Id

Id to uniquely identify the deferral within a specific process.

This API was introduced in Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2).

Process

DkmProcess represents a target process which is being debugged. The debugger debugs processes, so this is the basic unit of debugging. A DkmProcess can represent a system process or a virtual process such as minidumps.

This API was introduced in Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2).

Methods

Add()

Adds a request to defer load complete. This method should be called before the base debug monitor issues the load complete event (calls DkmProcess.OnLoadComplete).

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2).

Create(DkmProcess, Guid)

Create a new DkmLoadCompleteEventDeferral object instance. The deferral is not initially active, call 'Add' in order to all the deferral to the list of active deferrals.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2).

Remove()

Removes the load complete defer request. This method must be called on the event thread is response to a stopping/pausing event. If the base debug monitor has already called DkmProcess.OnLoadComplete prior to the final call to Remove, the final call to Remove will then fire the load complete event.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 12 Update 2 (DkmApiVersion.VS12Update2).

Applies to