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 |
---|---|
|
Der angegebene Leistungsindikator verwendet keine Zeitbasis. |
|
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 |