DkmStackFrame.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(DkmStackWalkFrame, DkmFrameFormatOptions, DkmCompilerId, String, String, DkmSourcePosition) |
Create a new DkmStackFrame object instance. Location constraint: API must be called from an IDE component (component level > 100,000). |
Create(DkmStackWalkFrame, DkmFrameFormatOptions, DkmCompilerId, String, String, DkmSourcePosition, Boolean) |
Create a new DkmStackFrame object instance. Location constraint: API must be called from an IDE component (component level > 100,000). This API was introduced in Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6). |
Create(DkmStackWalkFrame, DkmFrameFormatOptions, DkmCompilerId, String, String, DkmSourcePosition)
Create a new DkmStackFrame object instance.
Location constraint: API must be called from an IDE component (component level > 100,000).
public:
static Microsoft::VisualStudio::Debugger::CallStack::DkmStackFrame ^ Create(Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ Frame, Microsoft::VisualStudio::Debugger::CallStack::DkmFrameFormatOptions Options, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompilerId CompilerId, System::String ^ FrameName, System::String ^ ReturnType, Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePosition ^ SourcePosition);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackFrame Create (Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Frame, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions Options, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, string FrameName, string ReturnType, Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition SourcePosition);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackFrame Create (Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Frame, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions Options, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, string FrameName, string? ReturnType, Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition? SourcePosition);
static member Create : Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * string * string * Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackFrame
Public Shared Function Create (Frame As DkmStackWalkFrame, Options As DkmFrameFormatOptions, CompilerId As DkmCompilerId, FrameName As String, ReturnType As String, SourcePosition As DkmSourcePosition) As DkmStackFrame
Parameters
- Frame
- DkmStackWalkFrame
[In] Frame represents a frame on the call stack after filtering and translation.
- Options
- DkmFrameFormatOptions
[In] Collection of settings that affect how the stack provider formats a DkmStackFrame.
- CompilerId
- DkmCompilerId
[In] LanguageId/VendorId for the compiler which produced the code for this stack frame. If this is unknown (ex: no symbols loaded for this module), both values will be Guid.Empty. Otherwise, both values should be non-zero.
- FrameName
- String
[In] Name of the stack frame. DkmStackFrame.FormatOptions determines the format of the function name.
- ReturnType
- String
[In,Optional] Name of the stack frame's return type. This is only provided when DkmFrameNameFormatOptions.ReturnTypeField is set.
- SourcePosition
- DkmSourcePosition
[In,Optional] Source code location for this stack frame. This is only provided when DkmFrameNameFormatOptions.DocumentPositionField is set.
Returns
[Out] Result of this method call.
Applies to
Create(DkmStackWalkFrame, DkmFrameFormatOptions, DkmCompilerId, String, String, DkmSourcePosition, Boolean)
Create a new DkmStackFrame object instance.
Location constraint: API must be called from an IDE component (component level > 100,000).
This API was introduced in Visual Studio 15 Update 6 (DkmApiVersion.VS15Update6).
public:
static Microsoft::VisualStudio::Debugger::CallStack::DkmStackFrame ^ Create(Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ Frame, Microsoft::VisualStudio::Debugger::CallStack::DkmFrameFormatOptions Options, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompilerId CompilerId, System::String ^ FrameName, System::String ^ ReturnType, Microsoft::VisualStudio::Debugger::Symbols::DkmSourcePosition ^ SourcePosition, bool IsStale);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackFrame Create (Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Frame, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions Options, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, string FrameName, string ReturnType, Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition SourcePosition, bool IsStale);
public static Microsoft.VisualStudio.Debugger.CallStack.DkmStackFrame Create (Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame Frame, Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions Options, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, string FrameName, string? ReturnType, Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition? SourcePosition, bool IsStale);
static member Create : Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.CallStack.DkmFrameFormatOptions * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * string * string * Microsoft.VisualStudio.Debugger.Symbols.DkmSourcePosition * bool -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackFrame
Public Shared Function Create (Frame As DkmStackWalkFrame, Options As DkmFrameFormatOptions, CompilerId As DkmCompilerId, FrameName As String, ReturnType As String, SourcePosition As DkmSourcePosition, IsStale As Boolean) As DkmStackFrame
Parameters
- Frame
- DkmStackWalkFrame
[In] Frame represents a frame on the call stack after filtering and translation.
- Options
- DkmFrameFormatOptions
[In] Collection of settings that affect how the stack provider formats a DkmStackFrame.
- CompilerId
- DkmCompilerId
[In] LanguageId/VendorId for the compiler which produced the code for this stack frame. If this is unknown (ex: no symbols loaded for this module), both values will be Guid.Empty. Otherwise, both values should be non-zero.
- FrameName
- String
[In] Name of the stack frame. DkmStackFrame.FormatOptions determines the format of the function name.
- ReturnType
- String
[In,Optional] Name of the stack frame's return type. This is only provided when DkmFrameNameFormatOptions.ReturnTypeField is set.
- SourcePosition
- DkmSourcePosition
[In,Optional] Source code location for this stack frame. This is only provided when DkmFrameNameFormatOptions.DocumentPositionField is set.
- IsStale
- Boolean
[In] Specifies if this stack frame is stale or not after an Edit and Continue.
Returns
[Out] Result of this method call.