DkmRawStackContext.GetNextRawFrames 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从调用堆栈获取下一个原始帧。 如果这是对特定 DkmRawStackContext 的第一次调用,则会返回第一帧。 此方法是获取调用堆栈的建议方法,因为堆栈提供程序维护物理堆栈的缓存。
此方法会将新工作项追加到指定的工作列表,并在追加工作项后返回。 工作项的实际处理是异步的。 向调用方发送请求完成后,将收到通过完成例程的通知。
位置约束:必须从 IDE 组件 (组件级别 100000) 中调用 API > 。
此 API 是在 Visual Studio 14 RTM (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> -> unit
Public Sub GetNextRawFrames (WorkList As DkmWorkList, RequestCount As Integer, CompletionRoutine As DkmCompletionRoutine(Of DkmGetNextRawFramesAsyncResult))
参数
- WorkList
- DkmWorkList
要将新工作项追加到的工作项。
- RequestCount
- Int32
中RequestCount 是调用方希望返回的帧数。 如果堆栈不包含多个帧,则 GetNextRawFrames 的实现可能会返回更少的帧。 负值或读取超过 MaxFrames 的请求 (当前 5000) 将被限制为 MaxFrames。
- CompletionRoutine
- DkmCompletionRoutine<DkmGetNextRawFramesAsyncResult>
请求完成时要触发的例程。 如果请求成功追加到工作列表中,则将始终激发 (包括) 取消操作时。 如果追加工作项失败,此操作永远不会激发。