Função QueryAuxiliaryCounterFrequency (realtimeapiset.h)

Consulta a frequência do contador auxiliar.

Sintaxe

HRESULT QueryAuxiliaryCounterFrequency(
  [out] PULONGLONG lpAuxiliaryCounterFrequency
);

Parâmetros

[out] lpAuxiliaryCounterFrequency

Ponteiro longo para um buffer de saída que contém a frequência de contador auxiliar especificada. Se não houver suporte para o contador auxiliar, o valor no buffer de saída será indefinido.

Retornar valor

Retornará S_OK se o contador auxiliar tiver suporte e E_NOTIMPL se não houver suporte para o contador auxiliar.

Comentários

Você pode determinar a disponibilidade do contador auxiliar comparando o valor retornado com E_NOTIMPL.

Exemplos

O exemplo a seguir descreve como chamar QueryAuxiliaryCounterFrequency para recuperar a frequência do contador.

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

Requisitos