IDkmStackWalkFrameInterfaceProvider.GetFrameInspectionInterface 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.
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
[Out] Returned frame interface. This may be cast to the interface pointer corresponding to 'InterfaceID'.