Auf Englisch lesen

Freigeben über


KSEVENT_ITEM Struktur (ks.h)

Die KSEVENT_ITEM Struktur beschreibt die Unterstützung eines Minidrivers für ein bestimmtes Ereignis innerhalb eines Ereignissatzes.

Syntax

typedef struct {
  ULONG            EventId;
  ULONG            DataInput;
  ULONG            ExtraEntryData;
  PFNKSADDEVENT    AddHandler;
  PFNKSREMOVEEVENT RemoveHandler;
  PFNKSHANDLER     SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;

Angehörige

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.

Bemerkungen

Ein Minidriver, der die AddHandler- und RemoveHandler-Member angibt und die Ereignisse nicht ordnungsgemäß bereinigen, kann zu einem Speicher-/Handle-Speicherverlust führen.

Anforderungen

Anforderung Wert
Header- ks.h (enthalten Ks.h)

Siehe auch

IOCTL_KS_DISABLE_EVENT

KSEVENTDATA-

KSEVENT_ENTRY

KsDefaultAddEventHandler