Fungsi panggilan balik PFNKSADDEVENT (ks.h)
Rutinitas AVStrMiniAddEvent AVStream minidriver dipanggil ketika klien mendaftar untuk diberi tahu tentang suatu peristiwa. Rutinitas ini bersifat opsional.
Sintaks
PFNKSADDEVENT Pfnksaddevent;
NTSTATUS Pfnksaddevent(
[in] PIRP Irp,
[in] PKSEVENTDATA EventData,
[in] _KSEVENT_ENTRY *EventEntry
)
{...}
Parameter
[in] Irp
Menentukan IRP yang menjelaskan permintaan penambahan peristiwa.
[in] EventData
Penunjuk ke struktur KSEVENTDATA yang menjelaskan metode pemberitahuan untuk peristiwa ini.
[in] EventEntry
Penunjuk ke struktur KSEVENT_ENTRY yang dihasilkan AVStream yang menjelaskan bagaimana peristiwa dipicu.
Nilai kembali
AVStrMiniAddEvent harus mengembalikan STATUS_SUCCESS atau kesalahan khusus untuk peristiwa yang diaktifkan.
Keterangan
Jika Anda tidak menyediakan penanganan aktivitas tambahkan, AVStream menambahkan peristiwa ke daftar objek. Lihat Penanganan Peristiwa di AVStream.
Sering kali panggilan balik ini menerapkan perilaku khusus vendor dan kemudian memanggil KsFilterAddEvent atau KsPinAddEvent. Minidriver melewati pointer EventEntry yang diterima di sini dalam panggilan ke KsFilterAddEvent atau KsPinAddEvent.
Minidriver menentukan alamat rutin ini di anggota AddHandler dari struktur KSEVENT_ITEM . Penanganan Peristiwa di AVStream menjelaskan bagaimana minidriver menyediakan struktur ini kepada driver kelas.
Jika minidriver AVStream menentukan AddHandler sebagai non-NULL, AVStream tidak menambahkan item ke daftar peristiwa objek. Jika minidriver menentukan AddHandler dan tidak menambahkan peristiwa ke daftar peristiwa objek melalui KsDefaultAddEventHandler() atau panggilan Ks*AddEvent , minidriver bertanggung jawab untuk membersihkan peristiwa.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru serta DirectX 8.0 dan versi DirectX yang lebih baru. |
| Target Platform | Desktop |
| Header | ks.h (termasuk Ks.h) |