struktur KSEVENT_ITEM (ks.h)
Struktur KSEVENT_ITEM menjelaskan dukungan minidriver untuk peristiwa tertentu dalam set peristiwa.
Sintaks
typedef struct {
ULONG EventId;
ULONG DataInput;
ULONG ExtraEntryData;
PFNKSADDEVENT AddHandler;
PFNKSREMOVEEVENT RemoveHandler;
PFNKSHANDLER SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;
Anggota
EventId
Menentukan ID unik peristiwa dalam set peristiwa.
DataInput
Menentukan ukuran dalam byte data peristiwa. Data peristiwa dimulai dengan struktur KSEVENTDATA yang menjelaskan bagaimana klien harus diberi tahu ketika peristiwa terjadi, secara opsional diikuti oleh parameter tambahan apa pun yang menentukan kapan peristiwa terjadi. Harus setidaknya sizeof (KSEVENTDATA).
ExtraEntryData
Menentukan ukuran dalam byte dari memori tambahan apa pun yang harus dialokasikan sistem untuk setiap permintaan aktif untuk peristiwa ini. Driver menggunakan memori ini untuk menyimpan data apa pun yang diperlukan untuk melacak permintaan peristiwa. Memori dialokasikan langsung setelah peristiwa mengaktifkan struktur KSEVENT_ENTRY permintaan.
AddHandler
Penunjuk ke rutinitas panggilan balik AVStrMiniAddEvent yang disediakan minidriver. Tidak digunakan oleh driver kelas stream. Hanya untuk minidriver AVStream.
RemoveHandler
Pointer ke rutinitas panggilan balik AVStrMiniRemoveEvent yang disediakan minidriver. Tidak digunakan oleh driver kelas stream. Hanya untuk minidriver AVStream.
SupportHandler
Tidak digunakan oleh driver kelas stream.
Keterangan
Minidriver yang menentukan anggota AddHandler dan RemoveHandler dan tidak membersihkan peristiwa dengan benar dapat menyebabkan kebocoran sumber daya (memori/handel).
Persyaratan
Persyaratan | Nilai |
---|---|
Header | ks.h (termasuk Ks.h) |