QueryPerformanceFrequency 함수(profileapi.h)

성능 카운터의 빈도를 검색합니다. 성능 카운터의 빈도는 시스템 부팅 시 고정되며 모든 프로세서에서 일관됩니다. 따라서 빈도는 애플리케이션 초기화 시 쿼리해야 하며 결과를 캐시할 수 있습니다.

구문

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

[out] lpFrequency

현재 성능 카운터 빈도(초당 개수)를 수신하는 변수에 대한 포인터입니다. 설치된 하드웨어가 고해상도 성능 카운터를 지원하지 않는 경우 이 매개 변수는 0일 수 있습니다(Windows XP 이상을 실행하는 시스템에서는 발생하지 않음).

설치된 하드웨어가 고해상도 성능 카운터를 지원하는 경우 반환 값은 0이 아닌 값입니다.

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

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

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