Metodo IDebugControl3::OutputStackTrace (dbgeng.h)

Il metodo OutputStackTrace restituisce il frame dello stack fornito o i frame dello stack corrente.

Sintassi

HRESULT OutputStackTrace(
  [in]           ULONG              OutputControl,
  [in, optional] PDEBUG_STACK_FRAME Frames,
  [in]           ULONG              FramesSize,
  [in]           ULONG              Flags
);

Parametri

[in] OutputControl

Specifica dove inviare l'output. Per i valori possibili, vedere DEBUG_OUTCTL_XXX.

[in, optional] Frames

Specifica la matrice di frame dello stack per l'output. Il numero di elementi in questa matrice è FrameSize. Se Frame è NULL, vengono usati i frame dello stack corrente.

[in] FramesSize

Specifica il numero di fotogrammi da restituire.

[in] Flags

Specifica i flag di bit che determinano le informazioni da restituire per ogni frame. I flag possono essere qualsiasi combinazione di valori della tabella seguente.

Flag Descrizione
DEBUG_STACK_ARGUMENTS Visualizza i primi tre pezzi di memoria dello stack nella cornice di ogni chiamata. Nelle piattaforme in cui i parametri vengono passati nello stack e il codice per il frame usa gli argomenti stack, questi valori saranno gli argomenti della funzione.
DEBUG_STACK_FUNCTION_INFO Visualizza informazioni sulla funzione corrispondente al frame. Ciò include le informazioni sulle convenzioni di chiamata e sull'omissione del puntatore a fotogrammi (FPO).
DEBUG_STACK_SOURCE_LINE Visualizza le informazioni sulla riga di origine per ogni frame della traccia dello stack.
DEBUG_STACK_FRAME_ADDRESSES Visualizza l'indirizzo restituito, l'indirizzo frame precedente e altri indirizzi pertinenti per ogni frame.
DEBUG_STACK_COLUMN_NAMES Visualizza i nomi delle colonne.
DEBUG_STACK_NONVOLATILE_REGISTERS Visualizza il contesto del registro non volatile per ogni frame. Questo è significativo solo per alcune piattaforme.
DEBUG_STACK_FRAME_NUMBERS Visualizza i numeri di cornice.
DEBUG_STACK_PARAMETERS Visualizza i nomi dei parametri e i valori specificati nelle informazioni sui simboli.
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY Visualizza solo l'indirizzo restituito negli indirizzi frame dello stack.
DEBUG_STACK_FRAME_MEMORY_USAGE Visualizza il numero di byte che separano i fotogrammi.
DEBUG_STACK_PARAMETERS_NEWLINE Visualizza ogni parametro e il relativo tipo e valore in una nuova riga.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito Descrizione
S_OK
Il metodo è stato eseguito correttamente.

Commenti

La matrice di frame dello stack può essere ottenuta usando GetStackTrace.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (includere Dbgeng.h)

Vedi anche

GetContextStackTrace

GetStackTrace

Idebugcontrol

IDebugControl2

IDebugControl3

k, kb, kc, kd, kp, kP, kv (Display Stack Backtrace)