Anzeigen von Leistungsdaten

Die meisten Leistungsindikatoren erfordern zwei Stichprobenwerte, um einen sichtbaren Wert zu berechnen. Die Formel für jeden Leistungsindikator bestimmt, ob der Indikator zwei Stichproben erfordert. Eine Liste der Leistungsindikatoren und deren Formeln finden Sie im Abschnitt Indikatortypen des Windows Server 2003 Deployment Kit.

Das Sammeln von Leistungsdaten zeigt, 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 Indikatorwert hoch- oder herunterskalieren müssen, um den Wert anzuzeigen, rufen Sie die PdhSetCounterScaleFactor-Funktion auf, bevor Sie PdhGetFormattedCounterValueaufrufen. Indikatorwerte können mit einer Potenz von zehn von einem Faktor von -7 auf 7 skaliert werden.

Wenn der Indikatorpfad ein Platzhalterzeichen für den Instanznamen enthält, rufen Sie PdhGetFormattedCounterArray auf, um ein Array formatierter Indikatorwerte für jede gesammelte Instanz abzurufen.

Sie können auch die Funktionen PdhCalculateCounterFromRawValue und PdhFormatFromRawValue verwenden, um einen darstellbaren 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 PdhGetRawCounterValue- oder PdhGetRawCounterArray-Funktion auf. Rufen Sie für zeitbasierte Indikatorwerte PdhGetCounterTimeBase vor PdhFormatFromRawValue auf, um die Zeitbasis des Indikators abzurufen.

Wenn Sie Berechnungen mithilfe der Rohdaten ausfü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 Leistungsindikator

Wenn Sie die Minimal-, Höchst- und Mittelwerte 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 den Mittelwert dann in eine Ausgabeprotokolldatei.