IDkmStackWalkFrameInterfaceProvider.GetFrameInspectionInterface Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.ComponentInterfaces

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

GetFrameInspectionInterface is used to obtain a ICorDebugFrame or other implementation-specific interfaces 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. NOTE: Using this method from managed code is not recommended for performance reasons. Marshalling of DkmStackWalkFrame between native and managed code is expensive. Use DkmRuntimeInstance.GetFrameInspectionInterface instead.

public:
 System::Object ^ GetFrameInspectionInterface(Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ frame, Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionSession ^ session, Guid interfaceID);

public object GetFrameInspectionInterface (Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame frame, Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession session, Guid interfaceID);

abstract member GetFrameInspectionInterface : Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession * Guid -> obj

Public Function GetFrameInspectionInterface (frame As DkmStackWalkFrame, session As DkmInspectionSession, interfaceID As Guid) As Object

Parameters

frame

DkmStackWalkFrame

[In] DkmStackWalkFrame represents a frame on a call stack which has been walked, but may not have been formatted or filtered. Formatted frames are represented by DkmStackFrame instead.

session

DkmInspectionSession

[In,Optional] DkmInspectionSession allows the various components which inspect data to store private data which is associated with a group of evaluations.

interfaceID

Guid

[In] The GUID of the desired interface. IID_ICorDebugFrame can be used to obtain the CorDebug frame interface for a managed frame. Other debug monitors or stack walkers may provide their own interface.

Returns

Object

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