Sdílet prostřednictvím

DkmStackWalkFrame.GetInspectionInterface(DkmInspectionSession, Guid) Method

  • Reference

Definition

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

GetInspectionInterface 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.

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

public:
 System::Object ^ GetInspectionInterface(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionSession ^ Session, Guid InterfaceID);
public object GetInspectionInterface (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession Session, Guid InterfaceID);
public object GetInspectionInterface (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession? Session, Guid InterfaceID);
member this.GetInspectionInterface : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession * Guid -> obj
Public Function GetInspectionInterface (Session As DkmInspectionSession, InterfaceID As Guid) As Object

Parameters

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'.

Applies to