KSEVENT_ITEM-Struktur (ks.h)
Die KSEVENT_ITEM-Struktur beschreibt die Unterstützung eines Minidrivers für ein bestimmtes Ereignis innerhalb einer Ereignismenge.
Syntax
typedef struct {
ULONG EventId;
ULONG DataInput;
ULONG ExtraEntryData;
PFNKSADDEVENT AddHandler;
PFNKSREMOVEEVENT RemoveHandler;
PFNKSHANDLER SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;
Member
EventId
Gibt die eindeutige ID des Ereignisses innerhalb des Ereignissatzes an.
DataInput
Gibt die Größe von Ereignisdaten in Bytes an. Die Ereignisdaten beginnen mit einer KSEVENTDATA-Struktur , die beschreibt, wie der Client beim Eintreten des Ereignisses benachrichtigt werden soll, optional gefolgt von zusätzlichen Parametern, die angeben, wann das Ereignis eintritt. Muss mindestens sizeof(KSEVENTDATA) sein.
ExtraEntryData
Gibt die Größe des zusätzlichen Arbeitsspeichers in Bytes an, den das System für jede Aktivierungsanforderung für dieses Ereignis zuordnen soll. Der Treiber verwendet diesen Arbeitsspeicher, um alle Daten zu speichern, die er zum Nachverfolgen der Ereignisanforderung benötigt. Der Arbeitsspeicher wird direkt nach der KSEVENT_ENTRY Struktur der Ereignisaktivieren-Anforderung zugewiesen.
AddHandler
Zeiger auf eine vom Minidriver bereitgestellte AVStrMiniAddEvent-Rückrufroutine . Wird nicht vom Streamklassentreiber verwendet. Nur für AVStream-Minidriver.
RemoveHandler
Zeiger auf eine vom Minidriver bereitgestellte AVStrMiniRemoveEvent-Rückrufroutine . Wird nicht vom Streamklassentreiber verwendet. Nur für AVStream-Minidriver.
SupportHandler
Wird nicht vom Streamklassentreiber verwendet.
Hinweise
Ein Minidriver, der die AddHandler- und RemoveHandler-Member angibt und die Ereignisse nicht ordnungsgemäß sauber, kann zu einem Ressourcenverlust (Arbeitsspeicher/Handle) führen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ks.h (einschließlich Ks.h) |