Поделиться через

DkmStackTraceContext.Create Method

  • Reference

Definition

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

Create a new DkmStackTraceContext object instance. The caller is responsible for closing the created object after they are done.

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

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

public:
 static Microsoft::VisualStudio::Debugger::CallStack::DkmStackTraceContext ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionSession ^ InspectionSession, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, Microsoft::VisualStudio::Debugger::CallStack::DkmCallStackFilterOptions FilterOptions, Microsoft::VisualStudio::Debugger::CallStack::DkmFrameFormatOptions FormatOptions, System::Collections::ObjectModel::ReadOnlyCollection<System::Byte> ^ ThreadContext, Microsoft::VisualStudio::Debugger::CallStack::DkmAsyncStackWalkContext ^ AsyncContext, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkOperation Operation, System::Collections::ObjectModel::ReadOnlyCollection<Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^> ^ Frames, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackTraceContext Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession InspectionSession, Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.CallStack.DkmCallStackFilterOptions FilterOptions, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions FormatOptions, System.Collections.ObjectModel.ReadOnlyCollection<byte> ThreadContext, Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext AsyncContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkOperation Operation, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.DkmInstructionAddress> Frames, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackTraceContext Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession InspectionSession, Microsoft.VisualStudio.Debugger.DkmThread Thread, Microsoft.VisualStudio.Debugger.CallStack.DkmCallStackFilterOptions FilterOptions, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions FormatOptions, System.Collections.ObjectModel.ReadOnlyCollection<byte>? ThreadContext, Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext? AsyncContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkOperation Operation, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.DkmInstructionAddress> Frames, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession * Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.CallStack.DkmCallStackFilterOptions * Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions * System.Collections.ObjectModel.ReadOnlyCollection<byte> * Microsoft.VisualStudio.Debugger.CallStack.DkmAsyncStackWalkContext * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkOperation * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.DkmInstructionAddress> * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackTraceContext
Public Shared Function Create (InspectionSession As DkmInspectionSession, Thread As DkmThread, FilterOptions As DkmCallStackFilterOptions, FormatOptions As DkmFrameFormatOptions, ThreadContext As ReadOnlyCollection(Of Byte), AsyncContext As DkmAsyncStackWalkContext, Operation As DkmStackWalkOperation, Frames As ReadOnlyCollection(Of DkmInstructionAddress), DataItem As DkmDataItem) As DkmStackTraceContext

Parameters

InspectionSession
DkmInspectionSession

[In] DkmInspectionSession allows the various components which inspect data to store private data which is associated with a group of evaluations.

Thread
DkmThread

[In] DkmThread represents a thread running in the target process.

FilterOptions
DkmCallStackFilterOptions

[In] Options for how the call stack should be filtered.

FormatOptions
DkmFrameFormatOptions

[In] Collection of settings that affect how the stack provider formats a DkmStackFrame.

ThreadContext
ReadOnlyCollection<Byte>

[In,Optional] The initial thread context to use when performing the stack walk. This value is normally 'null' but can be set in order to view another call stack (ex: .cxr).

AsyncContext
DkmAsyncStackWalkContext

[In,Optional] If we are fetching the continuation frames or task creation frames, specifies the context for the async stack walk operation.

Operation
DkmStackWalkOperation

[In] Which type of stack walk we are doing. If the operation is AsyncReturnStackWalk or AsyncTaskCreationStackWalk, "Task" must be non-null. Otherwise, "AsyncContext" must be NULL.

Frames
ReadOnlyCollection<DkmInstructionAddress>

[In] The captured frames to use.

DataItem
DkmDataItem

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

Returns

DkmStackTraceContext

[Out] Result of this method call.

Applies to