DkmStackWalkContext.RuntimeWalkNextFrames 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.
Overloads
| RuntimeWalkNextFrames(DkmWorkList, UInt32, DkmCompletionRoutine<DkmRuntimeWalkNextFramesAsyncResult>) |
Attempt to walk the stack without the use of symbols. This will call into various components that know how to walk portions of the stack (ex: CLR frames will be walked by the CLR debug monitor). An 'unresolved' frame will be left for portions of the stack which cannot be walked without information stored within the symbol file. These 'unresolved' frames have no InstructionAddress or Description. 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. |
| RuntimeWalkNextFrames(UInt32, Boolean) |
Attempt to walk the stack without the use of symbols. This will call into various components that know how to walk portions of the stack (ex: CLR frames will be walked by the CLR debug monitor). An 'unresolved' frame will be left for portions of the stack which cannot be walked without information stored within the symbol file. These 'unresolved' frames have no InstructionAddress or Description. |
RuntimeWalkNextFrames(DkmWorkList, UInt32, DkmCompletionRoutine<DkmRuntimeWalkNextFramesAsyncResult>)
Attempt to walk the stack without the use of symbols. This will call into various components that know how to walk portions of the stack (ex: CLR frames will be walked by the CLR debug monitor). An 'unresolved' frame will be left for portions of the stack which cannot be walked without information stored within the symbol file. These 'unresolved' frames have no InstructionAddress or Description.
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.
public:
void RuntimeWalkNextFrames(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, System::UInt32 RequestSizeHint, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::CallStack::DkmRuntimeWalkNextFramesAsyncResult> ^ CompletionRoutine);public void RuntimeWalkNextFrames (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, uint RequestSizeHint, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.CallStack.DkmRuntimeWalkNextFramesAsyncResult> CompletionRoutine);member this.RuntimeWalkNextFrames : Microsoft.VisualStudio.Debugger.DkmWorkList * uint32 * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.CallStack.DkmRuntimeWalkNextFramesAsyncResult> -> unitPublic Sub RuntimeWalkNextFrames (WorkList As DkmWorkList, RequestSizeHint As UInteger, CompletionRoutine As DkmCompletionRoutine(Of DkmRuntimeWalkNextFramesAsyncResult))Parameters
- WorkList
- DkmWorkList
WorkList to append the new work item to.
- RequestSizeHint
- UInt32
[In] RequestSizeHint is a hint as to the number of frame that the caller needs. This value is treated as a hint because this API can return frames which are not yet walked, so this API may return more or less than the hint value.
- CompletionRoutine
- DkmCompletionRoutine<DkmRuntimeWalkNextFramesAsyncResult>
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.
Applies to
RuntimeWalkNextFrames(UInt32, Boolean)
Attempt to walk the stack without the use of symbols. This will call into various components that know how to walk portions of the stack (ex: CLR frames will be walked by the CLR debug monitor). An 'unresolved' frame will be left for portions of the stack which cannot be walked without information stored within the symbol file. These 'unresolved' frames have no InstructionAddress or Description.
public:
cli::array <Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^> ^ RuntimeWalkNextFrames(System::UInt32 RequestSizeHint, [Runtime::InteropServices::Out] bool % EndOfStack);public Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame[] RuntimeWalkNextFrames (uint RequestSizeHint, out bool EndOfStack);member this.RuntimeWalkNextFrames : uint32 * bool -> Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame[]Public Function RuntimeWalkNextFrames (RequestSizeHint As UInteger, ByRef EndOfStack As Boolean) As DkmStackWalkFrame()Parameters
- RequestSizeHint
- UInt32
[In] RequestSizeHint is a hint as to the number of frame that the caller needs. This value is treated as a hint because this API can return frames which are not yet walked, so this API may return more or less than the hint value.
- EndOfStack
- Boolean
[Out] Returns true if the monitor reached the end of the stack.
Returns
[Out] Array of walked frames. For, unresolved frames, both InstructionAddress and Description will be null.