Funzione QueryAuxiliaryCounterFrequency (realtimeapiset.h)

Articolo
03/05/2024

Esegue una query sulla frequenza del contatore ausiliario.

Sintassi

HRESULT QueryAuxiliaryCounterFrequency(
  [out] PULONGLONG lpAuxiliaryCounterFrequency
);

Parametri

[out] lpAuxiliaryCounterFrequency

Puntatore lungo a un buffer di output contenente la frequenza del contatore ausiliario specificata. Se il contatore ausiliario non è supportato, il valore nel buffer di output non verrà definito.

Valore restituito

Restituisce S_OK se il contatore ausiliario è supportato e E_NOTIMPL se il contatore ausiliario non è supportato.

Commenti

È possibile determinare la disponibilità del contatore ausiliario confrontando il valore restituito rispetto a E_NOTIMPL.

Esempio

Nell'esempio seguente viene descritto come chiamare QueryAuxiliaryCounterFrequency per recuperare la frequenza del contatore.

#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; 
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1703 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2016 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	realtimeapiset.h
Libreria	Mincore.lib
DLL	Kernel32.dll

Condividi tramite