Fungsi KsDiscardEvent (ks.h)
Fungsi KsDiscardEvent membuang memori yang digunakan oleh entri peristiwa setelah objek didereferensikan. Fungsi ini dapat dipanggil ketika menonaktifkan peristiwa secara manual yang belum dinonaktifkan oleh pemilik peristiwa (dengan memanggil fungsi KsFreeEventList untuk menonaktifkan peristiwa). Misalnya, fungsi dapat dipanggil ketika mengaktifkan peristiwa secara asinkron gagal dan entri peristiwa perlu dibuang.
Sintaks
KSDDKAPI VOID KsDiscardEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Parameter
[in] EventEntry
Menentukan penunjuk ke entri untuk dibuang. Penunjuk ini tidak lagi valid setelah panggilan berhasil ke fungsi ini.
Nilai kembali
Tidak ada
Keterangan
Biasanya, fungsi KsDiscardEvent secara otomatis dipanggil oleh fungsi KsDisableEvent ketika permintaan untuk menonaktifkan peristiwa terjadi, atau oleh fungsi KsFreeEventList ketika permintaan untuk membebaskan daftar peristiwa terjadi. Fungsi ini hanya dapat dipanggil pada PASSIVE_LEVEL.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |