QueryInterruptTime 함수(realtimeapiset.h)

아티클
03/05/2024

현재 인터럽트 시간 수를 가져옵니다. 보다 정확한 개수를 보려면 QueryInterruptTimePrecise를 사용합니다.

구문

void QueryInterruptTime(
  [out] PULONGLONG lpInterruptTime
);

매개 변수

[out] lpInterruptTime

100나노초의 시스템 시간 단위로 인터럽트 시간 수를 받을 ULONGLONG에 대한 포인터입니다. 초를 얻기 위해 1,000만 또는 1e7로 나눕니다(1초에 1e9나노초가 있으므로 1초에 1e7 100나노초가 있습니다).

반환 값

없음

설명

인터럽트 시간 수는 시스템이 시작될 때 0에서 시작하여 클록 틱의 길이에 따라 각 클록 인터럽트에서 증가합니다. 클록 틱의 정확한 길이는 기본 하드웨어에 따라 달라지며 시스템마다 다를 수 있습니다.

시스템 시간과 달리 인터럽트 시간 수는 사용자 또는 Windows 시간 서비스의 조정을 받지 않습니다. 애플리케이션은 인터럽트 시간 수를 사용하여 시스템 시간에 가능한 것보다 더 미세한 기간을 측정할 수 있습니다. 인터럽트 시간 수보다 정밀도가 높은 애플리케이션은 고해상도 타이머를 사용해야 합니다. QueryPerformanceFrequency 함수를 사용하여 고해상도 타이머의 빈도를 검색하고 QueryPerformanceCounter 함수를 사용하여 카운터의 값을 검색합니다.

timeBeginPeriod 및 timeEndPeriod 함수에서 설정한 타이머 해상도는 QueryInterruptTime 함수의 해상도에 영향을 줍니다. 그러나 프로세서가 절전 상태로 들어가지 못하게 하여 전체 시스템 성능을 줄이고 시스템 전력 소비를 늘릴 수 있으므로 타이머 해상도를 높이는 것은 권장되지 않습니다. 대신 애플리케이션은 고해상도 타이머를 사용해야 합니다.

참고 인터럽트 시간 수와 틱 수가 약 49일 정도 진행되므로 QueryInterruptTime 함수는 Windows의 디버그("checked") 빌드에서 다른 결과를 생성합니다. 이렇게 하면 시스템이 오랫동안 실행될 때까지 발생하지 않을 수 있는 버그를 식별할 수 있습니다. 확인된 빌드는 MSDN (Microsoft Developer Network) 웹 사이트를 통해 MSDN 구독자가 사용할 수 있습니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0601 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항

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