KSEVENT_ITEM Struktur (ks.h)
Die KSEVENT_ITEM Struktur beschreibt die Unterstützung eines Minidrivers für ein bestimmtes Ereignis innerhalb eines Ereignissatzes.
typedef struct {
ULONG EventId;
ULONG DataInput;
ULONG ExtraEntryData;
PFNKSADDEVENT AddHandler;
PFNKSREMOVEEVENT RemoveHandler;
PFNKSHANDLER SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;
EventId
Gibt die eindeutige ID des Ereignisses innerhalb des Ereignissatzes an.
DataInput
Gibt die Größe in Byte von Ereignisdaten an. Die Ereignisdaten beginnen mit einer KSEVENTDATA- Struktur, die beschreibt, wie der Client benachrichtigt werden soll, wenn das Ereignis eintritt, optional gefolgt von zusätzlichen Parametern, die angeben, wann das Ereignis eintritt. Muss mindestens Größe von(KSEVENTDATA) sein.
ExtraEntryData
Gibt die Größe in Byte eines zusätzlichen Arbeitsspeichers an, den das System für jede Aktivierungsanforderung für dieses Ereignis zuordnen soll. Der Treiber verwendet diesen Speicher, um alle Daten zu speichern, die er benötigt, um die Ereignisanforderung nachzuverfolgen. Der Speicher wird direkt nach der KSEVENT_ENTRY Struktur der Ereignisaktivierenanforderung 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.
Ein Minidriver, der die AddHandler- und RemoveHandler-Member angibt und die Ereignisse nicht ordnungsgemäß bereinigen, kann zu einem Speicher-/Handle-Speicherverlust führen.
Anforderung | Wert |
---|---|
Header- | ks.h (enthalten Ks.h) |