DkmProcessSnapshot.Create Method

Definition

Creates a new process snapshot object. This method is called from the base debug monitor on the event thread as part of processing of TakeSnapshot.

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

This API was introduced in Visual Studio 15 Update 3 (DkmApiVersion.VS15Update3).

public:
 static Microsoft::VisualStudio::Debugger::DkmProcessSnapshot ^ Create(System::UInt32 Id, int ProcessId, Microsoft::VisualStudio::Debugger::DkmProcess ^ OriginalProcess, System::UInt64 TimeStamp, int StoppingThreadId, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcessSnapshot Create (uint Id, int ProcessId, Microsoft.VisualStudio.Debugger.DkmProcess OriginalProcess, ulong TimeStamp, int StoppingThreadId, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.DkmProcessSnapshot Create (uint Id, int ProcessId, Microsoft.VisualStudio.Debugger.DkmProcess OriginalProcess, ulong TimeStamp, int StoppingThreadId, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : uint32 * int * Microsoft.VisualStudio.Debugger.DkmProcess * uint64 * int * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcessSnapshot
Public Shared Function Create (Id As UInteger, ProcessId As Integer, OriginalProcess As DkmProcess, TimeStamp As ULong, StoppingThreadId As Integer, DataItem As DkmDataItem) As DkmProcessSnapshot

Parameters

Id
UInt32

[In] An increasing number to identify the snapshot within a process.

ProcessId
Int32

[In] Process Id assigned to the Snapshot by the operating system.

OriginalProcess
DkmProcess

[In] The process that this snapshot is associate with.

TimeStamp
UInt64

[In] The timestamp of the debug event for which the snapshot is taken. Typically, it's obtained via QueryPerformanceCounter when the debug event occurs.

StoppingThreadId
Int32

[In] The id of the stopping thread. It usually is used to set the UI when we attach to a snapshot.

DataItem
DkmDataItem

[In,Optional] Data object to add to the new DkmProcessSnapshot instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

[Out] Result of this method call.

Applies to