描述
藉由向上查看堆疊並記錄每個畫面的資訊,以擷取堆疊回溯追蹤。
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:FramesToSkip和FramesToCapture參數的總和必須小於 63。
BackTrace [out]
從目前堆疊追蹤擷取的指標陣列。
BackTraceHash [out, 選擇性]
可用來組織雜湊表的值。 如果此參數為 Null,則不會計算雜湊值。
此值是根據 BackTrace 陣列中傳回的指標值來計算。 兩個相同的堆疊追蹤會產生相同的雜湊值。
傳回
擷取的框架數目。
備註
CaptureStackBackTrace函式定義為RtlCaptureStackBackTrace函式, (定義包含在 Windows SDK 中,從 Windows Vista) 開始。 如需詳細資訊,請參閱 WinBase.h 和 WinNT.h。