Fungsi PerfSetCounterRefValue (perflib.h)
Updates nilai penghitung yang nilainya adalah penunjuk ke data aktual. Penyedia menggunakan fungsi ini.
Sintaks
ULONG PerfSetCounterRefValue(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE Instance,
[in] ULONG CounterId,
[in] PVOID Address
);
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] Address
Arahkan ke data penghitung aktual.
Jika NULL, konsumen menerima ERROR_NO_DATA.
Untuk menunjukkan bahwa data penghitung diakses oleh referensi, deklarasi penghitung dalam manifes harus menyertakan elemen counterAttribute yang atribut namanya diatur ke "referensi".
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 menentukan referensi ke data penghitung mentah. Untuk memperbarui referensi ke data penghitung mentah sendiri, gunakan anggota Offset dari struktur PERF_COUNTER_INFO untuk mengakses nilai penghitung untuk penghitung tertentu. Anggota Attrib harus menyertakan bendera PERF_ATTRIB_BY_REFERENCE. Blok struktur PERF_COUNTERSET_INSTANCE berisi satu atau beberapa struktur informasi penghitung.
Bergantung pada jenis penghitung, penunjuk harus mereferensikan bilangan bulat yang tidak ditandatangani 4-byte atau 8-byte. Saat mengumpulkan data penghitung, PERFLIB mendereferensikan pointer dan mengembalikan data aktual.
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 |