KeQueryPerformanceCounter 함수(wdm.h)

아티클
02/27/2024

KeQueryPerformanceCounter 루틴은 성능 카운터의 현재 값과 빈도를 검색합니다.

KeQueryPerformanceCounter를 사용하여 시간 간격 측정을 위한 고해상도(<1μs) 타임스탬프를 획득합니다.

구문

NTHALAPI LARGE_INTEGER KeQueryPerformanceCounter(
  [out, optional] PLARGE_INTEGER PerformanceFrequency
);

매개 변수

[out, optional] PerformanceFrequency

KeQueryPerformanceCounter가 성능 카운터 빈도를 초당 틱 단위로 쓰는 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 호출자에게 카운터 빈도 값이 필요하지 않은 경우 NULL일 수 있습니다.

반환 값

KeQueryPerformanceCounter는 성능 카운터 값을 틱 단위로 반환합니다.

설명

KeQueryPerformanceCounter 는 고해상도 단조로 감소하지 않는 카운터의 현재 값을 나타내는 64비트 정수를 반환합니다.

성능 카운터의 빈도를 가져오려면 PerformanceFrequency 매개 변수에 NULL이 아닌 포인터 값을 지정합니다. 성능 카운터의 빈도는 시스템 부팅 시 고정되며 모든 프로세서에서 일관됩니다. 따라서 드라이버는 초기화 중에 성능 카운터의 빈도를 캐시할 수 있습니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	Hal.lib
DLL	Hal.dll
IRQL	모든 수준