Fungsi KsEnableEvent (ks.h)
Fungsi KsEnableEvent memungkinkan peristiwa yang diminta melalui IOCTL_KS_ENABLE_EVENT. Ini merespons semua pengidentifikasi peristiwa yang ditentukan oleh set. Fungsi ini hanya dapat dipanggil pada PASSIVE_LEVEL.
Sintaks
KSDDKAPI NTSTATUS KsEnableEvent(
[in] PIRP Irp,
[in] ULONG EventSetsCount,
[in] const KSEVENT_SET *EventSet,
[in, out] PLIST_ENTRY EventsList,
[in, optional] KSEVENTS_LOCKTYPE EventsFlags,
[in, optional] PVOID EventsLock
);
Parameter
[in] Irp
Menentukan IRP dengan permintaan aktifkan yang sedang ditangani. Objek file yang terkait dengan IRP disimpan dengan peristiwa untuk perbandingan nanti saat menonaktifkan peristiwa.
[in] EventSetsCount
Menunjukkan jumlah struktur set peristiwa yang diteruskan.
[in] EventSet
Menentukan penunjuk ke daftar informasi kumpulan peristiwa.
[in, out] EventsList
Jika mengaktifkan KSEVENT_SET peristiwa. AddHandler untuk set peristiwa adalah NULL, itu harus menunjuk ke kepala daftar item KSEVENT_ENTRY tempat peristiwa akan ditambahkan. Fungsi ini mengasumsikan satu daftar untuk setidaknya subset peristiwa.
[in, optional] EventsFlags
Menentukan bendera KSEVENTS_LOCKTYPE yang menentukan jenis kunci pengecualian yang akan digunakan dalam mengakses daftar peristiwa, jika ada. Jika tidak ada bendera yang diatur, maka tidak ada kunci yang diambil. Jika handler sudah ditentukan, parameter ini diabaikan.
[in, optional] EventsLock
Jika KSEVENT_SET. AddHandler untuk kumpulan peristiwa yang berisi peristiwa yang diaktifkan adalah NULL, maka ini digunakan untuk menyinkronkan akses ke daftar. Nilai ini dapat berupa NULL jika tidak ada bendera yang diatur dalam EventsFlags.
Nilai kembali
Fungsi KsEnableEvent mengembalikan STATUS_SUCCESS jika berhasil, atau kesalahan khusus untuk peristiwa yang diaktifkan jika tidak berhasil. Fungsi ini selalu mengatur IO_STATUS_BLOCK. Bidang informasi PIRP. Elemen IoStatus dalam IRP ke nol. Ini tidak mengatur IO_STATUS_BLOCK. Bidang status, juga tidak menyelesaikan IRP.
Keterangan
Minidriver tidak memanggil KsEnableEvent. Hanya driver KS murni atau driver kelas yang harus memanggil rutinitas ini.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |