Condividi tramite

DkmClrRuntimeInstance.GetCorFrame(DkmThread, UInt64, Guid) Method

  • Reference

Definition

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

GetCorFrame is used to obtain a ICorDebugFrame which a component can use to deeply inspect the stack frame.

The returned interface may ONLY be used to inspect the target process, and should NEVER be used to control execution (no stepping, no breakpoints, no continue, etc). Doing so is unsupported and will result in undefined behavior.

Location constraint: This API must be called from the same process where the target runtime implements stack walk. For managed debugging, this means that when debugging 64-bit or remote processes, this API must be called from a debug monitor component.

This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

public:
 System::Object ^ GetCorFrame(Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, System::UInt64 FrameBase, Guid InterfaceID);
public object GetCorFrame (Microsoft.VisualStudio.Debugger.DkmThread Thread, ulong FrameBase, Guid InterfaceID);
member this.GetCorFrame : Microsoft.VisualStudio.Debugger.DkmThread * uint64 * Guid -> obj
Public Function GetCorFrame (Thread As DkmThread, FrameBase As ULong, InterfaceID As Guid) As Object

Parameters

Thread
DkmThread

[In] The thread the stack frame came from.

FrameBase
UInt64

[In] The frame base of the stack frame to get the inspection interface for.

InterfaceID
Guid

[In] The GUID of the desired interface. IID_ICorDebugFrame can be used to obtain the CorDebug frame interface for a managed frame.

Returns

Object

[Out] Returned frame interface. This may be cast to the interface pointer corresponding to 'InterfaceID'.

Applies to