PHW_EVENT_ROUTINE fungsi panggilan balik (strmini.h)

Driver kelas memanggil rutinitas StrMiniEvent minidriver stream untuk memberi sinyal ke minidriver, suatu peristiwa harus diaktifkan atau dinonaktifkan.

Sintaks

PHW_EVENT_ROUTINE PhwEventRoutine;

NTSTATUS PhwEventRoutine(
  [in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}

Parameter

[in] EventDescriptor

Menjelaskan peristiwa, dan apakah harus diaktifkan atau dinonaktifkan.

Nilai kembali

Untuk peristiwa yang mengaktifkan peristiwa, StrMiniEvent mengembalikan STATUS_SUCCESS jika peristiwa berhasil diaktifkan, atau kode kesalahan pada kegagalan. Driver kelas mengabaikan nilai pengembalian pada permintaan nonaktifkan.

Keterangan

Driver kelas mengantre struktur KSEVENT_ENTRY yang diteruskannya di EventDescriptor-EventEntry>. Setiap anggota EventDescriptor lainnya dibatalkan alokasinya setelah StrMiniEvent keluar, sehingga data khusus peristiwa apa pun yang terkandung dalam anggota EventDataEventDescriptor yang perlu disimpan minidriver harus disimpan oleh minidriver.

Untuk tujuan itu, minidriver dapat mengalokasikan ruang langsung setelah struktur KSEVENT_ENTRY dengan memberikan nilai bukan nol di anggota ExtraEntryData dari struktur KSEVENT_ITEM yang digunakan untuk mendeklarasikan peristiwa.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	strmini.h (termasuk Strmini.h)