Freigeben über

IAMGraphBuilderCallback::CreatedFilter-Methode (strmif.h)

  • Artikel

[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.]

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.

Syntax

HRESULT CreatedFilter(
  IBaseFilter *pFil
);

Parameter

pFil

Zeiger auf die IBaseFilter-Schnittstelle des Filters.

Rückgabewert

Wenn die Methode einen Erfolgscode zurückgibt, versucht der Filtergraph-Manager, eine Verbindung mit dem Filter herzustellen. Wenn die Methode einen Fehlercode zurückgibt, lehnt der Filter graph-Manager den Filter ab.

Hinweise

Diese Methode ermöglicht es dem Client, den Filter unmittelbar nach der Erstellung zu konfigurieren. Der VideoMischungsrenderer ist das primäre Beispiel für einen Filter, der eine Konfiguration erfordert, bevor er verbunden wird. Die meisten anderen DirectShow-Filter können konfiguriert werden, nachdem sie verbunden wurden.

Der Filter Graph-Manager enthält einen graphweiten kritischen Abschnitt, während er diese Methode aufruft. Daher sollte die Rückrufmethode vermeiden, dass Methoden im Filter Graph-Manager oder Methoden für Filter aufgerufen werden, die den Graphzustand ändern (z. B. das Trennen von Pins). Dies kann zu einem Deadlock oder anderen unerwarteten Verhaltensweisen führen.

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)
Bibliothek Strmiids.lib

Weitere Informationen

IAMGraphBuilderCallback-Schnittstelle