Metodo IDebugControl4::OutputContextStackTrace (dbgeng.h)

Articolo
08/07/2023

Il metodo OutputContextStackTrace stampa lo stack di chiamate specificato da una matrice di frame dello stack e contesti di registro corrispondenti.

Sintassi

HRESULT OutputContextStackTrace(
  [in] ULONG              OutputControl,
  [in] PDEBUG_STACK_FRAME Frames,
  [in] ULONG              FramesSize,
  [in] PVOID              FrameContexts,
  [in] ULONG              FrameContextsSize,
  [in] ULONG              FrameContextsEntrySize,
  [in] ULONG              Flags
);

Parametri

[in] OutputControl

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

[in] Frames

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

[in] FramesSize

Specifica il numero di fotogrammi da restituire.

[in] FrameContexts

Specifica il contesto di registrazione per ogni frame nello stack. Le voci di questa matrice corrispondono alle voci della matrice Frame . Il tipo del contesto del thread è la struttura CONTEXT per il processore efficace della destinazione.

[in] FrameContextsSize

Specifica le dimensioni, in byte, della memoria puntata da FrameContexts. Il numero di frame dello stack deve corrispondere al numero di contesti e FrameContextsSize deve essere uguale a FrameSize moltiplicato da FrameContextsEntrySize.

[in] FrameContextsEntrySize

Specifica le dimensioni, in byte, di ogni contesto frame in FrameContexts.

[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 gli argomenti vengono passati nello stack e il codice per il frame usa gli argomenti dello 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 del 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 GetContextStackTrace.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (include Dbgeng.h, Ntddk.h)

Vedi anche

GetContextStackTrace

IDebugControl4

OutputStackTrace

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