Funzione RtlCaptureStackBackTrace (winnt.h)

  • Articolo

La routine RtlCaptureStackBackTrace acquisisce un'analisi dello stack eseguendo l'analisi dello stack e registrando le informazioni per ogni fotogramma.

Sintassi

NTSYSAPI WORD RtlCaptureStackBackTrace(
  [in]            DWORD  FramesToSkip,
  [in]            DWORD  FramesToCapture,
  [out]           PVOID  *BackTrace,
  [out, optional] PDWORD BackTraceHash
);

Parametri

[in] FramesToSkip

Numero di fotogrammi da ignorare dall'inizio della traccia indietro.

[in] FramesToCapture

Numero di fotogrammi da acquisire.

[out] BackTrace

Matrice di puntatori acquisiti dall'analisi dello stack corrente.

[out, optional] BackTraceHash

Valore facoltativo che può essere usato per organizzare le tabelle hash. Se questo parametro è NULL, non viene calcolato alcun valore hash.

Questo valore viene calcolato in base ai valori dei puntatori restituiti nella matrice BackTrace . Due tracce dello stack identiche genereranno valori hash identici.

Valore restituito

Numero di fotogrammi acquisiti.

Requisiti

   
Client minimo supportato Disponibile a partire da Windows XP.
Piattaforma di destinazione Universale
Intestazione winnt.h (include Ntifs.h, FltKernel.h)
Libreria NtosKrnl.lib; OneCoreUAP.lib in Windows 10
DLL NtDll.dll (modalità utente); NtosKrnl.exe (modalità kernel)
IRQL <= DISPATCH_LEVEL