Compartir a través de

Función RtlCaptureStackBackTrace (winnt.h)

  • Artículo

La rutina RtlCaptureStackBackTrace captura un seguimiento de retroceso de la pila caminando por la pila y registrando la información de cada fotograma.

Sintaxis

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

Parámetros

[in] FramesToSkip

Número de marcos que se van a omitir desde el inicio del seguimiento de retroceso.

[in] FramesToCapture

Número de marcos que se van a capturar.

[out] BackTrace

Matriz de punteros capturados desde el seguimiento de pila actual.

[out, optional] BackTraceHash

Valor opcional 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.

Valor devuelto

Número de marcos capturados.

Requisitos

   
Cliente mínimo compatible Disponible en a partir de Windows XP.
Plataforma de destino Universal
Encabezado winnt.h (incluya Ntifs.h, FltKernel.h)
Library NtosKrnl.lib; OneCoreUAP.lib en Windows 10
Archivo DLL NtDll.dll (modo de usuario); NtosKrnl.exe (modo kernel)
IRQL <= DISPATCH_LEVEL