Anzeigen von Leistungsdaten

Die meisten Leistungsindikatoren erfordern zwei Beispielwerte, um einen anzeigebaren Wert zu berechnen. Die Formel für jeden Zähler bestimmt, ob für den Zähler zwei Stichproben erforderlich sind. Eine Liste der Leistungsindikatoren und deren Formeln finden Sie im Abschnitt Leistungsindikatorentypen des Windows Server 2003 Deployment Kit.

Beim Sammeln von Leistungsdaten wird gezeigt, wie Beispieldaten abgerufen werden. Sobald Sie über die Beispiele verfügen, rufen Sie in der Regel PdhGetFormattedCounterValue auf, um einen anzeigebaren Wert zu berechnen.

Wenn Sie den Zählerwert nach oben oder unten skalieren müssen, um den Wert anzuzeigen, rufen Sie die PdhSetCounterScaleFactor-Funktion auf, bevor Sie PdhGetFormattedCounterValue aufrufen. Zählerwerte können mit einer Leistung von zehn von einem Faktor von -7 auf 7 skaliert werden.

Wenn der Zählerpfad ein Wildcardzeichen für den namen des instance enthält, rufen Sie PdhGetFormattedCounterArray auf, um ein Array formatierter Zählerwerte für jede erfasste instance abzurufen.

Sie können auch die Funktionen PdhCalculateCounterFromRawValue und PdhFormatFromRawValue verwenden, um einen anzeigebaren Wert zu berechnen. Um diese Funktionen verwenden zu können, müssen Sie das gesammelte Beispiel nach jedem PdhCollectQueryData-Aufruf abrufen und das Beispiel selbst speichern. Rufen Sie zum Abrufen des Beispiels die Funktion PdhGetRawCounterValue oder PdhGetRawCounterArray auf . Rufen Sie für zeitbasierte Zählerwerte PdhGetCounterTimeBase vor PdhFormatFromRawValue auf, um die Zeitbasis des Indikators abzurufen.

Wenn Sie Berechnungen mit den Rohdaten durchführen, überprüfen Sie immer den CStatus-Member der PDH_RAW_COUNTER-Struktur , bevor Sie das Beispiel verwenden. Das Beispiel ist ungültig, wenn der Wert von CStatus nicht PDH_CSTATUS_NEW_DATA oder PDH_CSTATUS_VALID_DATA ist.

Anzeigen von Statistiken für einen Indikator

Wenn Sie die minimalen, maximalen und mittleren Werte eines Zählers berechnen möchten, rufen Sie die PdhComputeCounterStatistics-Funktion auf . Wenn Sie Beispiele sammeln, speichern Sie die PDH_RAW_COUNTER Strukturen in einem Array, das Sie an PdhComputeCounterStatistics übergeben. Die Funktion gibt die statistischen Werte in einer PDH_STATISTICS-Struktur zurück.

Sie können diese Funktion auch verwenden, um eine Protokolldatei zu komprimieren. Lesen Sie beispielsweise zehn Datensätze aus einer Protokolldatei, rufen Sie PdhComputeCounterStatistics auf, um den Mittelwert zu berechnen, und schreiben Sie dann den Mittelwert in eine Ausgabeprotokolldatei.