IDebugControl2::OutputStackTrace-Methode (dbgeng.h)
Die OutputStackTrace-Methode gibt entweder den angegebenen Stapelrahmen oder die aktuellen Stapelframes aus.
Syntax
HRESULT OutputStackTrace(
[in] ULONG OutputControl,
[in, optional] PDEBUG_STACK_FRAME Frames,
[in] ULONG FramesSize,
[in] ULONG Flags
);
Parameter
[in] OutputControl
Gibt an, wohin die Ausgabe gesendet werden soll. Mögliche Werte finden Sie unter DEBUG_OUTCTL_XXX.
[in, optional] Frames
Gibt das Array von Stapelframes an, die ausgegeben werden sollen. Die Anzahl der Elemente in diesem Array ist FramesSize. Wenn FramesNULL ist, werden die aktuellen Stapelrahmen verwendet.
[in] FramesSize
Gibt die Anzahl der auszugebenden Frames an.
[in] Flags
Gibt Bitflags an, die bestimmen, welche Informationen für jeden Frame ausgegeben werden sollen. Flags können eine beliebige Kombination von Werten aus der folgenden Tabelle sein.
Flag | Beschreibung |
---|---|
DEBUG_STACK_ARGUMENTS | Zeigt die ersten drei Teile des Stapelspeichers im Rahmen jedes Aufrufs an. Auf Plattformen, auf denen Parameter auf dem Stapel übergeben werden und der Code für den Frame Stapelargumente verwendet, sind diese Werte die Argumente für die Funktion. |
DEBUG_STACK_FUNCTION_INFO | Zeigt Informationen zur Funktion an, die dem Frame entspricht. Dies schließt das Aufrufen von Konventions- und Framezeigerunterlassungsinformationen (FPO) ein. |
DEBUG_STACK_SOURCE_LINE | Zeigt Quellzeileninformationen für jeden Frame der Stapelablaufverfolgung an. |
DEBUG_STACK_FRAME_ADDRESSES | Zeigt die Rückgabeadresse, die vorherige Frameadresse und andere relevante Adressen für jeden Frame an. |
DEBUG_STACK_COLUMN_NAMES | Zeigt Spaltennamen an. |
DEBUG_STACK_NONVOLATILE_REGISTERS | Zeigt den nicht flüchtigen Registerkontext für jeden Frame an. Dies ist nur für einige Plattformen sinnvoll. |
DEBUG_STACK_FRAME_NUMBERS | Zeigt Framenummern an. |
DEBUG_STACK_PARAMETERS | Zeigt Parameternamen und Werte an, die in Symbolinformationen angegeben sind. |
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY | Zeigt nur die Rückgabeadresse in Stapelrahmenadressen an. |
DEBUG_STACK_FRAME_MEMORY_USAGE | Zeigt die Anzahl der Bytes an, die die Frames trennen. |
DEBUG_STACK_PARAMETERS_NEWLINE | Zeigt jeden Parameter sowie seinen Typ und Wert in einer neuen Zeile an. |
Rückgabewert
Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode war erfolgreich. |
Hinweise
Das Array von Stapelframes kann mithilfe von GetStackTrace abgerufen werden.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | dbgeng.h (einschließlich Dbgeng.h) |