Функция 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
Header realtimeapiset.h
Библиотека Mincore.lib
DLL Kernel32.dll