DkmStackContext.GetNextFrames(DkmWorkList, Int32, DkmCompletionRoutine<DkmGetNextFramesAsyncResult>) Methode

Definition

Abrufen der nächsten Frames aus der-Rückruf Stapel. Wenn dies der erste-Vorgang für einen bestimmten dkmstackcontext ist, werden die ersten Frames zurückgegeben. Diese Methode ist die empfohlene Vorgehensweise zum Abrufen der Rückruf Stapel, da der Stapel Anbieter einen Cache des physischen Stapels verwaltet.

Diese Methode fügt ein neues Arbeits Element an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeits Element angefügt wurde. Die tatsächliche Verarbeitung der Arbeitsaufgabe erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Abschluss Routine abgeschlossen wurde.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

public:
 void GetNextFrames(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, int RequestSize, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::CallStack::DkmGetNextFramesAsyncResult> ^ CompletionRoutine);
public void GetNextFrames (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, int RequestSize, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.CallStack.DkmGetNextFramesAsyncResult> CompletionRoutine);
member this.GetNextFrames : Microsoft.VisualStudio.Debugger.DkmWorkList * int * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.CallStack.DkmGetNextFramesAsyncResult> -> unit
Public Sub GetNextFrames (WorkList As DkmWorkList, RequestSize As Integer, CompletionRoutine As DkmCompletionRoutine(Of DkmGetNextFramesAsyncResult))

Parameter

WorkList
DkmWorkList

Worklist, an das das neue Arbeits Element angefügt werden soll.

RequestSize
Int32

In Requestsize ist die Anzahl der Frames, die der Aufrufer zurückgibt. Die Implementierung von getnextframes gibt möglicherweise weniger Frames zurück, wenn der Stapel nicht die Anzahl der Frames enthält. Negative Werte oder eine Anforderung zum Lesen von mehr als maxframes (derzeit 5.000) werden auf maxframes begrenzt.

CompletionRoutine
DkmCompletionRoutine<DkmGetNextFramesAsyncResult>

Die Routine, die nach Abschluss der Anforderung ausgelöst werden soll. Wenn die Anforderung erfolgreich an die Arbeitsliste angehängt wird, wird diese immer ausgelöst (auch wenn der Vorgang abgebrochen wird). Dies wird nie ausgelöst, wenn das Anfügen der Arbeitsaufgabe fehlschlägt.

Gilt für