PFNKSADDEVENT-Rückruffunktion (ks.h)
Die AVStrMiniAddEvent-Routine eines AVStream Minidrivers wird aufgerufen, wenn ein Client registriert wird, 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 das IRP an, das 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 avStream-generierte KSEVENT_ENTRY Struktur, die beschreibt, wie das Ereignis ausgelöst wird.
Rückgabewert
AVStrMiniAddEvent- sollte STATUS_SUCCESS oder einen Fehler zurückgeben, der für das aktivierte Ereignis spezifisch ist.
Bemerkungen
Wenn Sie keinen Add-Ereignishandler bereitstellen, fügt AVStream das Ereignis der Objektliste hinzu. Siehe Ereignisbehandlung in AVStream.
Häufig implementiert dieser Rückruf anbieterspezifisches Verhalten und ruft dann KsFilterAddEvent oder KsPinAddEventauf. Der Minidriver übergibt den hier empfangenen EventEntry Zeiger in Aufrufen von KsFilterAddEvent oder KsPinAddEvent-.
Der Minidriver gibt die Adresse dieser Routine im AddHandler Member einer KSEVENT_ITEM Struktur an. Ereignisbehandlung in AVStream beschreibt, wie der Minidriver diese Struktur dem Klassentreiber bereitstellt.
Wenn ein AVStream-Minidriver AddHandler- als nicht NULL angibt, fügt AVStream das Element nicht zur Ereignisliste des Objekts hinzu. Wenn minidriver eine AddHandler- angibt und das Ereignis nicht über KsDefaultAddEventHandler() oder einem Ks*AddEvent Aufruf des Objekts hinzugefügt, ist der Minidriver für das Bereinigen des Ereignisses verantwortlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Desktop |
| Header- | ks.h (enthalten Ks.h) |