Freigeben über


PdhGetCounterTimeBase-Funktion (pdh.h)

Gibt die Zeitbasis des angegebenen Leistungsindikators zurück.

Syntax

PDH_FUNCTION PdhGetCounterTimeBase(
  [in]  PDH_HCOUNTER hCounter,
  [out] LONGLONG     *pTimeBase
);

Parameter

[in] hCounter

Handle mit dem Zähler. Die PdhAddCounter-Funktion gibt dieses Handle zurück.

[out] pTimeBase

Zeitbasis, die die Anzahl der Leistungswerte angibt, die ein Zählerbeispiel pro Sekunde aufweist.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte aufgeführt.

Rückgabecode Beschreibung
PDH_INVALID_ARGUMENT
Der angegebene Leistungsindikator verwendet keine Zeitbasis.
PDH_INVALID_HANDLE
Das Zählerhandle ist ungültig.

Hinweise

Wenn Sie die PdhFormatFromRawValue-Funktion verwenden, um einen anzeigebaren Wert zu berechnen, anstatt die PdhCalculateCounterFromRawValue-Funktion aufzurufen, müssen Sie die PdhGetCounterTimeBase-Funktion aufrufen, um die Zeitbasis abzurufen.

Für jeden Leistungsindikator, der zeitbasierte Leistungsdaten zurückgibt, ist eine Zeitbasis definiert. Die Zeitbasis eines Zählers ist die Häufigkeit, mit der ein Zähler Daten pro Sekunde abzählt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile pdh.h
Bibliothek Pdh.lib
DLL Pdh.dll

Weitere Informationen

PdhFormatFromRawValue