QueryPerformanceCounter 함수(profileapi.h)

시간 간격 측정에 사용할 수 있는 고해상도(<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 앱]
대상 플랫폼	윈도우즈
Header	profileapi.h(Windows.h 포함)
Library	Kernel32.lib
DLL	Kernel32.dll