IDistributorNotify-Schnittstelle (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Über IDistributorNotify die Schnittstelle kann ein Plug-In-Verteiler benachrichtigt werden, wenn sich das Filterdiagramm ändert.
Anwendungen verwenden diese Schnittstelle niemals. Implementieren Sie diese Schnittstelle, wenn Sie einen Plug-In-Verteiler (PID) schreiben und möchten, dass die PID Benachrichtigungen zu Steuerelementen und Änderungen in der Zusammensetzung von Filterdiagrammen empfängt.
Der Filter Graph Manager fragt diese Schnittstelle für alle Plug-In-Verteiler ab, die aggregiert werden. Wenn eine PID diese Schnittstelle verfügbar macht, benachrichtigt der Filtergraph-Manager die PID über alle Zustandsänderungen, indem er die IDistributorNotify-Methoden aufruft , bevor die entsprechenden IBaseFilter-Methoden für die Filter aufgerufen werden. Der Filter Graph-Manager ruft auch die IDistributorNotify::NotifyGraphChange-Methode auf, wenn ein Filter hinzugefügt oder entfernt wird oder pin-Verbindungen geändert werden.
Halten Sie während eines Aufrufs einer IDistributorNotify-Methode keinen kritischen Abschnitt, der von einem anderen Codepfad gespeichert werden kann, der Methoden im Filter Graph-Manager aufruft. Dies kann zu einem Deadlock führen.
Vererbung
Die IDistributorNotify-Schnittstelle erbt von der IUnknown-Schnittstelle . IDistributorNotify verfügt auch über folgende Membertypen:
Methoden
Die IDistributorNotify-Schnittstelle verfügt über diese Methoden.
| IDistributorNotify::NotifyGraphChange Die NotifyGraphChange-Methode wird aufgerufen, wenn sich der Filtersatz im Filterdiagramm ändert oder sich pin-Verbindungen ändern. |
| IDistributorNotify::P ause Die Pause-Methode wird aufgerufen, wenn das Filterdiagramm in einen angehaltenen Zustand wechselt. |
| IDistributorNotify::Run Die Run-Methode wird aufgerufen, wenn das Filterdiagramm in den Ausführungszustand wechselt. |
| IDistributorNotify::SetSyncSource Die SetSyncSource-Methode wird aufgerufen, wenn eine neue Uhr registriert wird. |
| IDistributorNotify::Stop Die Stop-Methode wird aufgerufen, wenn das Filterdiagramm in einen beendeten Zustand wechselt. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |