Fungsi PcwUnregister (wdm.h)

Artikel
02/27/2024

Fungsi PcwUnregister menutup pendaftaran counterset yang ditentukan. Sebagian besar pengembang akan menggunakan fungsi UnregisterXxx yang dihasilkan CTRPP alih-alih memanggil fungsi ini secara langsung.

Sintaks

void PcwUnregister(
  PPCW_REGISTRATION Registration
);

Parameter

Registration

[dalam pointer A ke pendaftaran sedang ditutup.

Nilai kembali

Tidak ada

Keterangan

Fungsi PcwUnregister menutup pendaftaran counterset yang ditentukan. Instans yang dimiliki oleh pendaftaran counterset ditutup secara otomatis. Instans ini tidak boleh diakses oleh penyedia saat counterset tidak terdaftar atau setelah counterset tidak terdaftar.

Sebelum penyedia menggunakan fungsi ini, penyedia harus memanggil fungsi PcwRegister untuk membuat pendaftaran.

Fungsi UnregisterXxx yang dihasilkan CTRPP

Sebagian besar pengembang tidak perlu menelepon PcwUnregister secara langsung. Sebaliknya, mereka akan mengkompilasi manifes dengan alat CTRPP dan menggunakan fungsi UnregisterXxx dari header yang dihasilkan CTRPP. Fungsi yang dihasilkan akan terlihat seperti ini:

EXTERN_C FORCEINLINE VOID
UnregisterMyCounterset(
    VOID
    )
{
    PAGED_CODE();

    PcwUnregister(MyCounterset);
}

Fungsi Unregister yang dihasilkan CTRPP akan diberi nama PrefixUnregisterCounterSet. Awalan biasanya kosong, tetapi mungkin ada jika -prefix parameter digunakan pada baris perintah CTRPP. CounterSet adalah nama counterset, seperti yang ditentukan dalam manifes. Perhatikan bahwa fungsi mereferensikan variabel Counterset (MyCounterset dalam contoh), yang merupakan variabel global yang menyimpan handel pendaftaran counterset yang diinisialisasi oleh fungsi RegisterXxx yang dihasilkan CTRPP.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi Windows yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= APC_LEVEL

Lihat juga

Fungsi PcwRegister

Bagikan melalui