DkmThread.GetTopStackWalkFrame(DkmRuntimeInstance) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Debugger

Assembly:: Microsoft.VisualStudio.Debugger.Engine.dll

Package:: Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

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.

Return the top stack frame for a thread. This frame can come from a runtime instance, or a monitor unwinder. This can only be called from the server process. To obtain the top frame in the client process, use GetTopStackFrame.

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

public:
 Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ GetTopStackWalkFrame(Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ RuntimeInstance);

public Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame GetTopStackWalkFrame (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance);

member this.GetTopStackWalkFrame : Microsoft.VisualStudio.Debugger.DkmRuntimeInstance -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame

Public Function GetTopStackWalkFrame (RuntimeInstance As DkmRuntimeInstance) As DkmStackWalkFrame

Parameters

RuntimeInstance: DkmRuntimeInstance

[In] The runtime instance of the frame.

Returns

DkmStackWalkFrame

[Out] The top stack frame.

Exceptions

DkmException

E_NO_FRAME is returned if no native runtime is present and there are no frames on the stack.

Applies to