VideoPortQueryPerformanceCounter 함수(video.h)

VideoPortQueryPerformanceCounter 함수는 시스템에서 사용할 수 있는 가장 세분화된 실행 횟수를 제공합니다.

구문

VIDEOPORT_API LONGLONG VideoPortQueryPerformanceCounter(
  IN PVOID      HwDeviceExtension,
  OUT PLONGLONG PerformanceFrequency
);

매개 변수

HwDeviceExtension

[in] 미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.

PerformanceFrequency

[out, optional] 성능 카운터 빈도를 수신하는 변수에 대한 선택적 포인터입니다.

반환 값

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

설명

VideoPortQueryPerformanceCounter는 항상 틱 수를 나타내는 64비트 정수를 반환합니다. 시스템 부팅 시 개수 누적이 시작됩니다. 개수는 틱입니다. 이 선택적 매개 변수가 제공되면 PerformanceFrequency 에서 빈도를 보고합니다.

PerformanceFrequency를 지정하여 현재 수를 누적하는 데 사용되는 타이머의 해상도를 얻을 수 있습니다. 예를 들어 반환된 PerformanceFrequency 가 200만 인 경우 각 틱은 1/2백만 초입니다. 개수의 각 1/x 백만 증분은 경과된 시간의 1초에 해당합니다.

VideoPortQueryPerformanceCounter 는 타임스탬핑 패킷 또는 컴퓨팅 성능 및 용량 측정을 위한 것입니다. 경과 시간을 측정하거나, 중단 또는 대기를 계산하거나, 반복하기 위한 것이 아닙니다.

이 루틴을 가능한 한 자주 사용하지 않습니다. 플랫폼에 따라 VideoPortQueryPerformanceCounter는 최소 간격 동안 시스템 전체 인터럽트를 사용하지 않도록 설정할 수 있습니다. 따라서 반복에서처럼 이 루틴을 자주 또는 반복적으로 호출하면 매우 세분화된 실행 중인 타임스탬프를 반환하는 목적이 무효화됩니다. 이 루틴을 너무 자주 호출하면 호출 드라이버 및 시스템 전체의 I/O 성능이 저하됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
대상 플랫폼	데스크톱
머리글	video.h(Video.h 포함)
라이브러리	Videoprt.lib
DLL	Videoprt.sys
IRQL	모든 수준