IAMGraphBuilderCallback-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 IAMGraphBuilderCallback -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. Der Filter Graph-Manager ruft die Methoden auf dieser Schnittstelle auf, während er den Graphen erstellt, wodurch der Client die Möglichkeit erhält, den Grapherstellungsprozess zu ändern.

Die primäre Verwendung für diese Schnittstelle besteht darin, den Video Mixing Renderer-Filter zu konfigurieren, bevor er verbunden wird. Sie können es auch verwenden, um einen bestimmten Filter während der Grapherstellung abzulehnen, z. B. einen Decoderfilter.

Vererbung

Die IAMGraphBuilderCallback-Schnittstelle erbt von der IUnknown-Schnittstelle . IAMGraphBuilderCallback verfügt auch über folgende Membertypen:

Methoden

Die IAMGraphBuilderCallback-Schnittstelle verfügt über diese Methoden.

IAMGraphBuilderCallback::CreatedFilter Der Graph-Manager für Filter ruft diese Methode auf, nachdem er einen Filter erstellt hat, aber bevor er versucht, eine Verbindung mit dem Filter herzustellen.
IAMGraphBuilderCallback::SelectedFilter Der Filter Graph-Manager ruft diese Methode auf, wenn er einen Kandidatenfilter für das Diagramm findet, aber bevor er den Filter erstellt.

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

IAMFilterGraphCallback-Schnittstelle