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
Library Mincore.lib
DLL Kernel32.dll