Freigeben über


PFNKSADDEVENT-Rückruffunktion (ks.h)

Die AVStrMiniAddEvent-Routine eines AVStream-Minidrivers wird aufgerufen, wenn sich ein Client registriert, um über ein Ereignis benachrichtigt zu werden. Diese Routine ist optional.

Syntax

PFNKSADDEVENT Pfnksaddevent;

NTSTATUS Pfnksaddevent(
  [in] PIRP Irp,
  [in] PKSEVENTDATA EventData,
  [in] _KSEVENT_ENTRY *EventEntry
)
{...}

Parameter

[in] Irp

Gibt die IRP an, die die Ereignis-Add-Anforderung beschreibt.

[in] EventData

Zeiger auf eine KSEVENTDATA-Struktur , die die Benachrichtigungsmethode für dieses Ereignis beschreibt.

[in] EventEntry

Zeiger auf eine von AVStream generierte KSEVENT_ENTRY Struktur, die beschreibt, wie das Ereignis ausgelöst wird.

Rückgabewert

AVStrMiniAddEvent sollte STATUS_SUCCESS oder einen für das aktivierte Ereignis spezifischen Fehler zurückgeben.

Hinweise

Wenn Sie keinen Add-Ereignishandler bereitstellen, fügt AVStream das Ereignis der Objektliste hinzu. Weitere Informationen finden Sie unter Ereignisbehandlung in AVStream.

Häufig implementiert dieser Rückruf anbieterspezifisches Verhalten und ruft dann KsFilterAddEvent oder KsPinAddEvent auf. Der Minidriver übergibt den EventEntry-Zeiger , der hier in Aufrufen von KsFilterAddEvent oder KsPinAddEvent empfangen wurde.

Der Minidriver gibt die Adresse dieser Routine im AddHandler-Member einer KSEVENT_ITEM-Struktur an. Die Ereignisbehandlung in AVStream beschreibt, wie der Minidriver diese Struktur für den Klassentreiber bereitstellt.

Wenn ein AVStream-Minidriver AddHandler als nicht NULL angibt, fügt AVStream das Element nicht zur Ereignisliste des Objekts hinzu. Wenn minidriver einen AddHandler angibt und das Ereignis nicht der Ereignisliste des Objekts über KsDefaultAddEventHandler() oder einen Ks*AddEvent-Aufruf hinzufügt, ist der Minitreiber für das Bereinigen des Ereignisses verantwortlich.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen.
Zielplattform Desktop
Kopfzeile ks.h (einschließlich Ks.h)

Weitere Informationen

AVStrMiniRemoveEvent

KSAUTOMATION_TABLE

KSEVENTDATA

KSEVENT_ENTRY

KSEVENT_ITEM

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents