IDkmStackProvider.GetNextFrames 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.
Obtain the next frames from the call stack. If this is the first call on a particular DkmStackContext then this will return the first frames. This method is the recommended way to obtain the call stack because the stack provider maintains a cache of the physical stack.
public:
void GetNextFrames(Microsoft::VisualStudio::Debugger::CallStack::DkmStackContext ^ stackContext, Microsoft::VisualStudio::Debugger::DkmWorkList ^ workList, int requestSize, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::CallStack::DkmGetNextFramesAsyncResult> ^ completionRoutine);public void GetNextFrames (Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext stackContext, Microsoft.VisualStudio.Debugger.DkmWorkList workList, int requestSize, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.CallStack.DkmGetNextFramesAsyncResult> completionRoutine);abstract member GetNextFrames : Microsoft.VisualStudio.Debugger.CallStack.DkmStackContext * Microsoft.VisualStudio.Debugger.DkmWorkList * int * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.CallStack.DkmGetNextFramesAsyncResult> -> unitPublic Sub GetNextFrames (stackContext As DkmStackContext, workList As DkmWorkList, requestSize As Integer, completionRoutine As DkmCompletionRoutine(Of DkmGetNextFramesAsyncResult))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.
- workList
- DkmWorkList
WorkList which is currently being processed. This value can be used to check for cancelation or to append additional work. New work items will not begin executing until after this function returns.
- requestSize
- Int32
[In] RequestSize is the number of frames that the caller would like returned. The implementation of GetNextFrames may return fewer frames in the case that stack does not contain that many frames. Negative values, or request to read more than MaxFrames (currently 5,000) will be capped to MaxFrames.
- completionRoutine
- DkmCompletionRoutine<DkmGetNextFramesAsyncResult>
Routine to fire when the request is complete. This will be implicitly fired if the implementation returns failure from this interface method. The implementation must fire this method in all other scenarios.