PerfIncrementULongCounterValue-Funktion (perflib.h)

Erhöht den Wert eines Zählers, dessen Wert eine 4-Byte-Ganzzahl ohne Vorzeichen ist. Anbieter verwenden diese Funktion.

Syntax

ULONG PerfIncrementULongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONG                     Value
);

Parameter

[in] Provider

Das Handle des Anbieters. Verwenden Sie die Handle-Variable, die das CTRPP-Tool für Sie generiert hat. Den Namen der Variablen finden Sie im Symbol-Attribut des Anbieterelements .

Windows Vista: Die PerfStartProvider-Funktion gibt das Handle zurück.

[in] Instance

Eine PERF_COUNTERSET_INSTANCE-Struktur, die den Zählersatz instance enthält. Die PerfCreateInstance-Funktion gibt diesen Zeiger zurück.

[in] CounterId

Bezeichner, der den zu aktualisierenden Zähler im instance-Block eindeutig identifiziert. Der Bezeichner wird im id-Attribut des Counterelements definiert und muss mit dem CounterId-Member einer der PERF_COUNTER_INFO Strukturen im instance-Block übereinstimmen. Verwenden Sie die Zähler-ID-Konstante, die das CTRPP-Tool für Sie generiert hat. Den Namen der Konstante finden Sie im Symbol-Attribut des Zählerelements .

Windows Vista: Die Zähler-ID-Konstante ist nicht verfügbar.

[in] Value

Wert, um den Zähler inkrementieren.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.

Hinweise

Dies ist eine Komfortfunktion zum Erhöhen von Rohdaten. Um die Rohdaten selbst zu erhöhen, verwenden Sie den Offset-Member der PERF_COUNTER_INFO-Struktur , um auf die Rohdaten für einen bestimmten Indikator zuzugreifen. Der PERF_COUNTERSET_INSTANCE-Strukturblock enthält mindestens eine Leistungsinformationsstruktur.

Verwenden Sie die PerfSetULongCounterValue-Funktion , um zunächst den Zählerwert festzulegen.

Beachten Sie, dass der Zählerwert überläuft, wenn der Zählerwert über die maximale Größe einer 4-Byte-Ganzzahl ohne Vorzeichen hinaus erhöht wird.

Anforderungen

Weitere Informationen

PerfDecrementULongCounterValue

PerfIncrementULongLongCounterValue

PerfSetULongCounterValue