Fonction QueryAuxiliaryCounterFrequency (realtimeapiset.h)

Interroge la fréquence du compteur auxiliaire.

Syntaxe

HRESULT QueryAuxiliaryCounterFrequency(
  [out] PULONGLONG lpAuxiliaryCounterFrequency
);

Paramètres

[out] lpAuxiliaryCounterFrequency

Pointeur long vers une mémoire tampon de sortie qui contient la fréquence de compteur auxiliaire spécifiée. Si le compteur auxiliaire n’est pas pris en charge, la valeur dans la mémoire tampon de sortie n’est pas définie.

Valeur retournée

Retourne S_OK si le compteur auxiliaire est pris en charge et E_NOTIMPL si le compteur auxiliaire n’est pas pris en charge.

Remarques

Vous pouvez déterminer la disponibilité du compteur auxiliaire en comparant la valeur retournée à E_NOTIMPL.

Exemples

L’exemple suivant décrit comment appeler QueryAuxiliaryCounterFrequency pour récupérer la fréquence du compteur.

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

Configuration requise