IAMFilterGraphCallback-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.]
Die IAMFilterGraphCallback -Schnittstelle bietet einen Rückrufmechanismus während der Grapherstellung.
Um diese Schnittstelle zu verwenden, implementieren Sie die -Schnittstelle in Ihrer Anwendung oder ihrem Clientobjekt. Fragen Sie den Filter Graph-Manager für die IObjectWithSite-Schnittstelle ab, und rufen Sie die IObjectWithSite::SetSite-Methode mit einem Zeiger auf Ihre Implementierung der Schnittstelle auf. Wenn der Filter Graph-Manager während der Grapherstellung einen Pin nicht rendern kann, ruft er die UnabletoRender-Methode auf. Der Client kann dann geeignete Maßnahmen ergreifen, z. B. eine Fehlermeldung für den Benutzer bereitstellen oder einen neuen Filter registrieren.
Vererbung
Die IAMFilterGraphCallback-Schnittstelle erbt von der IUnknown-Schnittstelle . IAMFilterGraphCallback verfügt auch über folgende Membertypen:
Methoden
Die IAMFilterGraphCallback-Schnittstelle verfügt über diese Methoden.
| IAMFilterGraphCallback::UnableToRender Die UnableToRender-Methode wird vom Filter Graph-Manager aufgerufen, wenn keine Kombination von Filtern zum Rendern des angegebenen Pins gefunden werden kann. |
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) |