Función QueryAuxiliaryCounterFrequency (realtimeapiset.h)

Consulta la frecuencia del contador auxiliar.

Sintaxis

HRESULT QueryAuxiliaryCounterFrequency(
  [out] PULONGLONG lpAuxiliaryCounterFrequency
);

Parámetros

[out] lpAuxiliaryCounterFrequency

Puntero largo a un búfer de salida que contiene la frecuencia de contador auxiliar especificada. Si no se admite el contador auxiliar, el valor del búfer de salida no se definirá.

Valor devuelto

Devuelve S_OK si se admite el contador auxiliar y E_NOTIMPL si no se admite el contador auxiliar.

Comentarios

Puede determinar la disponibilidad del contador auxiliar comparando el valor devuelto con E_NOTIMPL.

Ejemplos

En el ejemplo siguiente se describe cómo llamar a QueryAuxiliaryCounterFrequency para recuperar la frecuencia del 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

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1703 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2016 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	realtimeapiset.h
Library	Mincore.lib
Archivo DLL	Kernel32.dll