Fungsi PcwCloseInstance (wdm.h)

Artikel
02/29/2024

Fungsi ini PcwCloseInstance menutup instans counterset yang dibuat menggunakan PcwCreateInstance. Sebagian besar pengembang akan menggunakan fungsi CloseXxx yang dihasilkan CTRPP alih-alih memanggil fungsi ini secara langsung.

Sintaks

void PcwCloseInstance(
  [in] PPCW_INSTANCE Instance
);

Parameter

[in] Instance

Penunjuk ke instans counterset untuk ditutup.

Nilai kembali

Tidak ada

Keterangan

PcwCreateInstance Gunakan fungsi untuk membuat instans counterset.

Anda tidak dapat memanggil PcwCloseInstance instans jika Anda telah memanggil PcwUnregister untuk pendaftaran counterset yang sesuai. Saat Anda membatalkan pendaftaran counterset, instans yang tersisa akan ditutup untuk Anda. Menutupnya lagi akan merusak sistem.

Fungsi CloseXxx yang dihasilkan CTRPP

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

EXTERN_C FORCEINLINE VOID
CloseMyCounterset(
    __in PPCW_INSTANCE Instance
    )
{
    PAGED_CODE();

    PcwCloseInstance(Instance);
}

Fungsi Close yang dihasilkan CTRPP akan diberi nama PrefixCloseCounterSet. Awalan biasanya kosong, tetapi mungkin ada jika -prefix parameter digunakan pada baris perintah CTRPP. CounterSet adalah nama penghitung, seperti yang ditentukan dalam manifes.

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 PcwCreateInstance

Bagikan melalui