Udostępnij za pośrednictwem

DkmStackContext.Create Method

  • Reference

Definition

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

Overloads

Create(DkmInspectionSession, DkmThread, DkmCallStackFilterOptions, DkmFrameFormatOptions, ReadOnlyCollection<Byte>, DkmDataItem)

Create a new DkmStackContext 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).
Create(DkmInspectionSession, DkmThread, DkmCallStackFilterOptions, DkmFrameFormatOptions, ReadOnlyCollection<Byte>, DkmAsyncStackWalkContext, DkmStackWalkOperation, DkmDataItem)

Create a new DkmStackContext 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).

Create(DkmInspectionSession, DkmThread, DkmCallStackFilterOptions, DkmFrameFormatOptions, ReadOnlyCollection<Byte>, DkmDataItem)

Create a new DkmStackContext 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).

public:
 static Microsoft::VisualStudio::Debugger::CallStack::DkmStackContext ^ 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::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext 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.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext 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.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.DkmDataItem -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext
Public Shared Function Create (InspectionSession As DkmInspectionSession, Thread As DkmThread, FilterOptions As DkmCallStackFilterOptions, FormatOptions As DkmFrameFormatOptions, ThreadContext As ReadOnlyCollection(Of Byte), DataItem As DkmDataItem) As DkmStackContext

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).

DataItem
DkmDataItem

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

Returns

DkmStackContext

[Out] Result of this method call.

Applies to

Create(DkmInspectionSession, DkmThread, DkmCallStackFilterOptions, DkmFrameFormatOptions, ReadOnlyCollection<Byte>, DkmAsyncStackWalkContext, DkmStackWalkOperation, DkmDataItem)

Create a new DkmStackContext 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::DkmStackContext ^ 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, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext 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, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext 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, 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 * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext
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, DataItem As DkmDataItem) As DkmStackContext

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.

DataItem
DkmDataItem

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

Returns

DkmStackContext

[Out] Result of this method call.

Applies to