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, optional]

해시 테이블을 구성하는 데 사용할 수 있는 값입니다. 이 매개 변수가 NULL이면 해시 값이 계산되지 않습니다.

이 값은 BackTrace 배열에서 반환된 포인터의 값을 기준으로 계산됩니다. 두 개의 동일한 스택 추적은 동일한 해시 값을 생성합니다.

반환

캡처된 프레임의 수입니다.

설명

CaptureStackBackTrace 함수는 RtlCaptureStackBackTrace 함수로 정의됩니다(정의는 Windows Vista로 시작하는 Windows SDK에 포함됨). 자세한 내용은 WinBase.h 및 WinNT.h를 참조하세요.

참고 항목