DkmRawStackContext.GetNextRawFrames 方法

定义

从调用堆栈获取下一个原始帧。 如果这是对特定 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>

请求完成时要触发的例程。 如果请求成功追加到工作列表中,则将始终激发 (包括) 取消操作时。 如果追加工作项失败,此操作永远不会激发。

适用于