QueryAuxiliaryCounterFrequency 함수(realtimeapiset.h)

보조 카운터 빈도를 쿼리합니다.

구문

HRESULT QueryAuxiliaryCounterFrequency(
  [out] PULONGLONG lpAuxiliaryCounterFrequency
);

매개 변수

[out] lpAuxiliaryCounterFrequency

지정된 보조 카운터 빈도를 포함하는 출력 버퍼에 대한 긴 포인터입니다. 보조 카운터가 지원되지 않으면 출력 버퍼의 값이 정의되지 않습니다.

반환 값

보조 카운터가 지원되는 경우 S_OK반환하고 보조 카운터가 지원되지 않는 경우 E_NOTIMPL.

설명

반환된 값을 E_NOTIMPL 비교하여 보조 카운터의 가용성을 확인할 수 있습니다.

예제

다음 샘플에서는 QueryAuxiliaryCounterFrequency를 호출하여 카운터 빈도를 검색하는 방법을 설명합니다.

#include <stdio.h> 
#include <windows.h> 
int 
wmain (int argc, wchar_t* argv[]) 
{

   ULONGLONG AuxiliaryCounterFrequency;
   HRESULT Result;

   Result = QueryAuxiliaryCounterFrequency(&AuxiliaryCounterFrequency); 
   if (SUCCEEDED(Result)) {
      wprintf(L"Auxiliary counter frequency is: %llu.\n", AuxiliaryCounterFrequency);
   } 
   else if (Result == E_NOTIMPL) {
      wprintf(L"Auxiliary counter is not supported.\n"); 
   }
	  else {
    wprintf(L"Error code: 0x%x.\n", Result);
   }

   return 0; 
} 

요구 사항

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