Função RtlCaptureStackBackTrace (winnt.h)

Artigo
08/27/2023

A rotina RtlCaptureStackBackTrace captura um rastreamento de stack back subindo a pilha e gravando as informações para cada quadro.

Sintaxe

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

Parâmetros

[in] FramesToSkip

O número de quadros a serem pulados do início do rastreamento de pilha.

[in] FramesToCapture

O número de quadros a serem capturados.

[out] BackTrace

Uma matriz de ponteiros capturada do rastreamento de pilha atual.

[out, optional] BackTraceHash

Um valor opcional que pode ser usado para organizar tabelas de hash. Se esse parâmetro for NULL, nenhum valor de hash será calculado.

Esse valor é calculado com base nos valores dos ponteiros retornados na matriz BackTrace . Dois rastreamentos de pilha idênticos gerarão valores de hash idênticos.

Valor retornado

O número de quadros capturados.

Requisitos


Cliente mínimo com suporte	Disponível em a partir do Windows XP.
Plataforma de Destino	Universal
Cabeçalho	winnt.h (inclua Ntifs.h, FltKernel.h)
Biblioteca	NtosKrnl.lib; OneCoreUAP.lib no Windows 10
DLL	NtDll.dll (modo de usuário); NtosKrnl.exe (modo kernel)
IRQL	<= DISPATCH_LEVEL

Compartilhar via