DkmRawStackContext.GetNextRawFrames 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 raw frames from the call stack. If this is the first call on a particular DkmRawStackContext 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.
This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.
Location constraint: API must be called from an IDE component (component level > 100,000).
This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
public:
void GetNextRawFrames(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, int RequestCount, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::CallStack::DkmGetNextRawFramesAsyncResult> ^ CompletionRoutine);public void GetNextRawFrames (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, int RequestCount, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.CallStack.DkmGetNextRawFramesAsyncResult> CompletionRoutine);member this.GetNextRawFrames : Microsoft.VisualStudio.Debugger.DkmWorkList * int * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.CallStack.DkmGetNextRawFramesAsyncResult> -> unitPublic Sub GetNextRawFrames (WorkList As DkmWorkList, RequestCount As Integer, CompletionRoutine As DkmCompletionRoutine(Of DkmGetNextRawFramesAsyncResult))Parameters
- WorkList
- DkmWorkList
WorkList to append the new work item to.
- RequestCount
- Int32
[In] RequestCount is the number of frames that the caller would like returned. The implementation of GetNextRawFrames 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<DkmGetNextRawFramesAsyncResult>
Routine to fire when the request is complete. If the request is successfully appended to the work list, this will always fire (including when the operation is canceled). This will never fire if appending the work item fails.