QueryAuxiliaryCounterFrequency-Funktion (realtimeapiset.h)

Fragt die Häufigkeit des Hilfsindikators ab.

Syntax

HRESULT QueryAuxiliaryCounterFrequency(
  [out] PULONGLONG lpAuxiliaryCounterFrequency
);

Parameter

[out] lpAuxiliaryCounterFrequency

Langer Zeiger auf einen Ausgabepuffer, der die angegebene Hilfszählerhäufigkeit enthält. Wenn der Hilfsindikator nicht unterstützt wird, ist der Wert im Ausgabepuffer nicht definiert.

Rückgabewert

Gibt S_OK zurück, wenn der Hilfsindikator unterstützt wird, und E_NOTIMPL , wenn der Hilfsindikator nicht unterstützt wird.

Hinweise

Sie können die Verfügbarkeit des Hilfsindikators ermitteln, indem Sie den zurückgegebenen Wert mit E_NOTIMPL vergleichen.

Beispiele

Im folgenden Beispiel wird beschrieben, wie QueryAuxiliaryCounterFrequency aufgerufen wird, um die Zählerhäufigkeit abzurufen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	realtimeapiset.h
Bibliothek	Mincore.lib
DLL	Kernel32.dll