DkmStackContext.Create Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
[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
[Out] Result of this method call.