CaptureStackBackTrace 函式

描述

藉由向上查看堆疊並記錄每個畫面的資訊,以擷取堆疊回溯追蹤。

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

參數

FramesToSkip [in]

要從回溯追蹤開頭略過的畫面數。

FramesToCapture [in]

要擷取的畫面數。 您可以擷取最多 MAXUSHORT 畫面格。

Windows Server 2003 和 Windows XP:FramesToSkipFramesToCapture參數的總和必須小於 63。

BackTrace [out]

從目前堆疊追蹤擷取的指標陣列。

BackTraceHash [out, 選擇性]

可用來組織雜湊表的值。 如果此參數為 Null,則不會計算雜湊值。

此值是根據 BackTrace 陣列中傳回的指標值來計算。 兩個相同的堆疊追蹤會產生相同的雜湊值。

傳回

擷取的框架數目。

備註

CaptureStackBackTrace函式定義為RtlCaptureStackBackTrace函式, (定義包含在 Windows SDK 中,從 Windows Vista) 開始。 如需詳細資訊,請參閱 WinBase.h 和 WinNT.h。

另請參閱