PdhComputeCounterStatistics-Funktion (pdh.h)

Artikel
08/25/2023

Berechnet Statistiken für einen Zähler aus einem Array von Rohwerten.

Syntax

PDH_FUNCTION PdhComputeCounterStatistics(
  [in]  PDH_HCOUNTER     hCounter,
  [in]  DWORD            dwFormat,
  [in]  DWORD            dwFirstEntry,
  [in]  DWORD            dwNumEntries,
  [in]  PPDH_RAW_COUNTER lpRawValueArray,
  [out] PPDH_STATISTICS  data
);

Parameter

[in] hCounter

Handle des Indikators, für den Sie Statistiken berechnen möchten. Die PdhAddCounter-Funktion gibt dieses Handle zurück.

[in] dwFormat

Bestimmt den Datentyp des formatierten Werts. Geben Sie einen der folgenden Werte an.

Wert	Bedeutung
PDH_FMT_DOUBLE	Gibt den berechneten Wert als Gleitkommawert mit doppelter Genauigkeit zurück.
PDH_FMT_LARGE	Gibt den berechneten Wert als 64-Bit-Integer zurück.
PDH_FMT_LONG	Gibt den berechneten Wert als lange ganze Zahl zurück.

Sie können den bitweisen inklusiven OR-Operator (|) verwenden, um den Datentyp mit einem der folgenden Skalierungsfaktoren zu kombinieren.

Wert	Bedeutung
PDH_FMT_NOSCALE	Wenden Sie die Skalierungsfaktoren des Zählers nicht in die Berechnung an.
PDH_FMT_NOCAP100	Zählerwerte größer als 100 (z. B. Zählerwerte, die die Prozessorlast auf Multiprozessorcomputern messen) werden nicht auf 100 zurückgesetzt. Das Standardverhalten besteht darin, dass Zählerwerte auf einen Wert von 100 begrenzt sind.
PDH_FMT_1000	Multiplizieren Sie den endgültigen Wert mit 1.000.

[in] dwFirstEntry

Nullbasierter Index des ersten rohen Zählerwerts, der zum Starten der Berechnungen verwendet werden soll. Der Indexwert muss auf den ältesten Eintrag im Puffer verweisen. Die Funktion beginnt bei diesem Eintrag und scannt den Puffer, wobei sie beim letzten Eintrag zurück an den Anfang des Puffers und bis zum DwFirstEntry-1-Eintrag umschlossen wird, wobei angenommen wird, dass es sich um die neuesten oder neuesten Daten handelt.

[in] dwNumEntries

Anzahl der unformatierten Zählerwerte im puffer lpRawValueArray .

[in] lpRawValueArray

Array von PDH_RAW_COUNTER Strukturen, die dwNumEntries-Einträge enthalten.

[out] data

Eine PDH_STATISTICS-Struktur , die die Indikatorenstatistiken empfängt.

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	Ein Argument ist nicht richtig oder falsch formatiert.
PDH_INVALID_HANDLE	Das Zählerhandle ist ungültig.

Anforderungen

Anforderung	Wert
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

PDH_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor

Freigeben über