Fungsi CounterInitialize

Artikel
06/13/2023

Mendaftarkan penyedia dan menginisialisasi set penghitung.

Sintaks

ULONG WINAPI CounterInitialize(void);

Parameter

Fungsi ini tidak memiliki parameter.

Menampilkan nilai

Mengembalikan ERROR_SUCCESS pada keberhasilan; jika tidak, kode kesalahan Win32 standar.

Keterangan

Penyedia Anda memanggil fungsi ini. Fungsi ini mencakup panggilan ke fungsi PerfStartProvider dan fungsi PerfSetCounterSetInfo .

Alat CTRPP menghasilkan fungsi sebaris ini saat Anda menentukan argumen -o . Nama fungsi menyertakan string awalan jika Anda menentukan argumen -prefiks .

Jika Anda menentukan argumen -MemoryRoutines atau -NotificationCallback (atau tentukan atribut panggilan balik untuk elemen penyedia ), tanda tangan CounterInitialize berubah menjadi berikut:

ULONG WINAPI CounterInitialize(
    __in_opt PERFLIBREQUEST NotificationCallback,
    __in_opt PERF_MEM_ALLOC MemoryAllocationFunction,
    __in_opt PERF_MEM_FREE MemoryFreeFunction,
    __inout_opt PVOID MemoryFunctionContext
);

Mana

NotificationCallback: Nama fungsi panggilan balik ControlCallback yang Anda terapkan untuk menerima pemberitahuan permintaan konsumen (misalnya, permintaan untuk menambahkan atau menghapus penghitung dari kueri). Atur ke NULL jika Anda tidak menerapkan fungsi panggilan balik ControlCallback .
MemoryAllocationFunction: Nama fungsi panggilan balik AllocateMemory Anda yang dipanggil PERFLIB untuk mengalokasikan memori. Atur ke NULL jika Anda tidak menentukan argumen -MemoryRoutines .
MemoryFreeFunction: Nama fungsi panggilan balik FreeMemory Anda yang dipanggil PERFLIB untuk membebaskan memori yang dialokasikan menggunakan fungsi AllocateMemory . Atur ke NULL jika MemoryAllocationFunctionADALAH NULL.
MemoryFunctionContext: Informasi konteks untuk diteruskan ke alokasi memori dan rutinitas gratis Anda. Bisa NULL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]

Bagikan melalui