共用方式為

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