PerfSetULongLongCounterValue-Funktion (perflib.h)
Updates den Wert eines Zählers, dessen Wert eine 8-Byte-Ganzzahl ohne Vorzeichen ist. Anbieter verwenden diese Funktion.
Syntax
ULONG PerfSetULongLongCounterValue(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE Instance,
[in] ULONG CounterId,
[in] ULONGLONG 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
Neuer 8-Byte-Zählerwert.
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 Festlegen von rohen Zählerdaten. Um die Rohdaten des Zählers selbst zu aktualisieren, verwenden Sie das Offset-Element der PERF_COUNTER_INFO-Struktur , um auf die Rohdaten für einen bestimmten Zähler zuzugreifen. Der PERF_COUNTERSET_INSTANCE-Strukturblock enthält mindestens eine Leistungsinformationsstruktur.
Sie können die Funktionen PerfIncrementULongLongCounterValue und PerfDecrementULongCounterValue verwenden, um den Zählerwert zu erhöhen bzw. zu dekrementieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | perflib.h |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |
Weitere Informationen
PerfDecrementULongLongCounterValue