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