Función CaptureStackBackTrace

Descripción

Captura un seguimiento posterior de la pila caminando por la pila y registrando la información de cada fotograma.

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

Parámetros

FramesToSkip [in]

Número de fotogramas que se van a omitir desde el inicio del seguimiento posterior.

FramesToCapture [in]

Número de fotogramas que se van a capturar. Puede capturar hasta marcos de MAXUSHORT .

Windows Server 2003 y Windows XP: La suma de los parámetros FramesToSkip y FramesToCapture debe ser inferior a 63.

BackTrace [out]

Matriz de punteros capturados desde el seguimiento de pila actual.

BackTraceHash [out, optional]

Valor que se puede usar para organizar tablas hash. Si este parámetro es NULL, no se calcula ningún valor hash.

Este valor se calcula en función de los valores de los punteros devueltos en la matriz BackTrace. Dos seguimientos de pila idénticos generarán valores hash idénticos.

Devoluciones

Número de fotogramas capturados.

Comentarios

La función CaptureStackBackTrace se define como la función RtlCaptureStackBackTrace (la definición se incluye en windows SDK a partir de Windows Vista). Para obtener más información, vea WinBase.h y WinNT.h.

Consulte también