Share via

DkmNonDebugProcessSnapshot Class

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.DefaultPort
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Package:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

DkmNonDebugProcessSnapshot represents a snapshot that's captured about a running (but not debugged) process.

This API was introduced in Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).

[System.Runtime.InteropServices.Guid("0e3b9305-8e98-de32-1743-70d89346cf28")]
public class DkmNonDebugProcessSnapshot : Microsoft.VisualStudio.Debugger.DkmDataContainer
[<System.Runtime.InteropServices.Guid("0e3b9305-8e98-de32-1743-70d89346cf28")>]
type DkmNonDebugProcessSnapshot = class
    inherit DkmDataContainer
Public Class DkmNonDebugProcessSnapshot
Inherits DkmDataContainer
Inheritance
Object
DkmDataContainer
DkmNonDebugProcessSnapshot
Attributes
GuidAttribute

Properties

Connection

The transport connection that is responsible for taking this snapshot.

This API was introduced in Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).
IsUnloaded

Returns true if a 'unloaded' event has been raised for this object (example: DkmThread::Unload is called) or if the object has been closed. Note that care must be used when checking this status as, without synchronization, the returned status may no longer be accurate the instruction after it is read.

(Inherited from DkmDataContainer)
ProcessId

Process Id assigned to the Snapshot by the operating system.

This API was introduced in Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).
UniqueId

UniqueId uniquely identifies the snapshot.

This API was introduced in Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).

Methods

GetDataItem<T>()

Gets the instance of 'T' which has been added to this container instance. If this container does not contain a 'T', this function will return null.

(Inherited from DkmDataContainer)
OpenAsync(DkmWorkList, Guid, DkmCompletionRoutine<DkmOpenNonDebugProcessSnapshotAsyncResult>)

Creates a hidden debug session to inspect the process snapshot taken by DkmTransportConnection.TakeMinimalProcessSnapshot.

This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.

Location constraint: API must be called from an IDE component (component level > 100,000).

This API was introduced in Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).
RemoveDataItem<T>()

Remove the instance of 'T' from this container. It is usually unnecessary to call this method as a data container will automatically be emptied when the object is closed.

(Inherited from DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Place a new item in the data container.

(Inherited from DkmDataContainer)
Terminate()

Closes a snapshot and frees the associated handle.

This API was introduced in Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).

Applies to