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) |