Condividi tramite


Metodo IDebugControl5::OutputStackTraceEx (dbgeng.h)

Il metodo OutputStackTraceEx restituisce lo stack frame fornito o gli stack frame correnti. Il metodo OutputStackTraceEx fornisce il supporto dei fotogrammi inline. Per altre informazioni sull'uso delle funzioni inline, vedere Debug di codice ottimizzato e funzioni inline.

Sintassi

HRESULT OutputStackTraceEx(
  [in]           ULONG                 OutputControl,
  [in, optional] PDEBUG_STACK_FRAME_EX 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 stack frame da restituire. Il numero di elementi in questa matrice è FramesSize. Se Frame è NULL, vengono usati gli stack frame correnti.

[in] FramesSize

Specifica il numero di fotogrammi da restituire.

[in] Flags

Specifica i flag di bit che determinano le informazioni da restituire per ogni fotogramma. Flag può essere qualsiasi combinazione di valori della tabella seguente.

Bandiera Descrizione
DEBUG_STACK_ARGUMENTS Visualizza i primi tre pezzi di memoria dello stack nel frame di ogni chiamata. Nelle piattaforme in cui i parametri vengono passati nello stack e il codice per il frame usa argomenti stack, questi valori saranno gli argomenti della funzione.
DEBUG_STACK_FUNCTION_INFO Visualizza informazioni sulla funzione che corrisponde al frame. Sono incluse le informazioni sulle convenzioni di chiamata e sull'omissione del puntatore a fotogrammi.This include calling convention and frame pointer omission (FPO).
DEBUG_STACK_SOURCE_LINE Visualizza le informazioni sulla riga di origine per ogni frame dell'analisi dello stack.
DEBUG_STACK_FRAME_ADDRESSES Visualizza l'indirizzo restituito, l'indirizzo del 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 fotogramma. Questo è significativo solo per alcune piattaforme.
DEBUG_STACK_FRAME_NUMBERS Visualizza i numeri di fotogramma.
DEBUG_STACK_PARAMETERS Visualizza i nomi e i valori dei parametri come indicato nelle informazioni sui simboli.
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY Visualizza solo l'indirizzo restituito negli indirizzi stack frame.
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 altri dettagli, vedere valori restituiti.

Codice restituito Descrizione
S_OK
Il metodo ha avuto esito positivo.

Osservazioni

È possibile ottenere la matrice di stack frame usando GetStackTraceEx.

Fabbisogno

Requisito Valore
piattaforma di destinazione Desktop
intestazione dbgeng.h (include Dbgeng.h)

Vedere anche

GetContextStackTraceEx

GetStackTraceEx

IDebugControl5

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