QueryPerformanceCounter 함수(profileapi.h)

아티클
03/01/2024

시간 간격 측정에 사용할 수 있는 고해상도(<1us) 타임스탬프를 나타내는 성능 카운터의 현재 값을 검색합니다.

구문

BOOL QueryPerformanceCounter(
  [out] LARGE_INTEGER *lpPerformanceCount
);

매개 변수

[out] lpPerformanceCount

현재 성능 카운터 값(개수)을 수신하는 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. Windows XP 이상을 실행하는 시스템에서는 함수가 항상 성공하므로 0을 반환하지 않습니다.

설명

이 함수 및 해당 사용에 대한 자세한 내용은 고해상도 타임스탬프를 획득을 참조하세요.

예제

// Gets the current number of ticks from QueryPerformanceCounter. Throws an
// exception if the call to QueryPerformanceCounter fails.
static inline int64_t GetTicks()
{
    LARGE_INTEGER ticks;
    if (!QueryPerformanceCounter(&ticks))
    {
        winrt::throw_last_error();
    }
    return ticks.QuadPart;
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	profileapi.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll