KSEVENT_ITEM-Struktur (ks.h)

Artikel
02/26/2024

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.