Fungsi PerfDecrementULongCounterValue (perflib.h)

Artikel
08/25/2023

Mengurangi nilai penghitung yang nilainya adalah bilangan bulat tanpa tanda 4 byte. Penyedia menggunakan fungsi ini.

Sintaks

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

Parameter

[in] Provider

Handel penyedia. Gunakan variabel handel yang dihasilkan alat CTRPP untuk Anda. Untuk nama variabel, lihat atribut simbol elemen penyedia .

Windows Vista: Fungsi PerfStartProvider mengembalikan handel.

[in] Instance

Struktur PERF_COUNTERSET_INSTANCE yang berisi instans set penghitung. Fungsi PerfCreateInstance mengembalikan penunjuk ini.

[in] CounterId

Pengidentifikasi yang secara unik mengidentifikasi penghitung untuk diperbarui di blok instans. Pengidentifikasi didefinisikan dalam atribut id elemen penghitung dan harus cocok dengan anggota CounterId dari salah satu struktur PERF_COUNTER_INFO di blok instans. Gunakan konstanta ID penghitung yang dihasilkan alat CTRPP untuk Anda. Untuk nama konstanta, lihat atribut simbol elemen penghitung .

Windows Vista: Konstanta ID penghitung tidak tersedia.

[in] Value

Nilai untuk mengurangi penghitung.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem.

Keterangan

Ini adalah fungsi kenyamanan untuk mengurangi data penghitung mentah. Untuk mengurangi data penghitung mentah sendiri, gunakan anggota Offset dari struktur PERF_COUNTER_INFO untuk mengakses data penghitung mentah untuk penghitung tertentu. Blok struktur PERF_COUNTERSET_INSTANCE berisi satu atau beberapa struktur informasi penghitung.

Gunakan fungsi PerfSetULongCounterValue untuk awalnya mengatur nilai penghitung.

Perhatikan bahwa nilai penghitung akan menurun ketika nilai penghitung menurun melewati nol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	perflib.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

PerfDecrementULongLongCounterValue

PerfIncrementULongCounterValue

PerfSetULongCounterValue

Bagikan melalui