Freigeben über


PdhComputeCounterStatistics-Funktion (pdh.h)

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