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)

Weitere Informationen

IAMGraphBuilderCallback-Schnittstelle