Funzione CaptureStackBackTrace

Descrizione

Acquisisce un'analisi dello stack back camminando sullo stack e registrando le informazioni per ogni fotogramma.

USHORT WINAPI CaptureStackBackTrace(
  _In_      ULONG  FramesToSkip,
  _In_      ULONG  FramesToCapture,
  _Out_     PVOID  *BackTrace,
  _Out_opt_ PULONG BackTraceHash
);

Parametri

FramesToSkip [in]

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

FramesToCapture [in]

Numero di fotogrammi da acquisire. È possibile acquisire fino ai fotogrammi MAXUSHORT .

Windows Server 2003 e Windows XP: La somma dei parametri FramesToSkip e FramesToCapture deve essere minore di 63.

BackTrace [out]

Matrice di puntatori acquisiti dall'analisi dello stack corrente.

BackTraceHash [out, facoltativo]

Valore che può essere utilizzato 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.

Restituisce

Numero di fotogrammi acquisiti.

Commenti

La funzione CaptureStackBackTrace viene definita come funzione RtlCaptureStackBackTrace (la definizione è inclusa in Windows SDK a partire da Windows Vista). Per altre informazioni, vedere WinBase.h e WinNT.h.

Vedere anche