IDkmCallStackFilter.FilterNextFrame 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.
Provides a filter with the next stack frame. A filter can simply pass this frame on through, it can suppress the frame by returning nothing, or it can provide its own set of annotated frames. The stack provider will ignore NotImplementedException (E_NOTIMPL). All other errors will truncate stack walk.
public:
cli::array <Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^> ^ FilterNextFrame(Microsoft::VisualStudio::Debugger::CallStack::DkmStackContext ^ stackContext, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ input);
public Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame[] FilterNextFrame (Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext stackContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame input);
public Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame[]? FilterNextFrame (Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext stackContext, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame? input);
abstract member FilterNextFrame : Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame[]
Public Function FilterNextFrame (stackContext As DkmStackContext, input As DkmStackWalkFrame) As DkmStackWalkFrame()
Parameters
- stackContext
- DkmStackContext
[In] DkmStackContext objects are created by components that wish to request the stack from the stack provider. A component needs to close the context after they have completed the stack walk. To obtain the stack a component should create this object and then call GetNextFrames.
- input
- DkmStackWalkFrame
[In,Optional] Input is the next frame to examine. After all frame have been filtered, this function will be called one last time with a null input frame. This lets the filter know that the call stack is fully processed.
Returns
[Out] 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.