IFileSourceFilter-Schnittstelle (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die IFileSourceFilter Schnittstelle wird durch Quellfilter verfügbar gemacht, um den Dateinamen und den Medientyp der Mediendatei festzulegen, die sie rendern sollen. Es handelt sich um eine abgekürzte Version der COM IPersistFile-Schnittstelle . Wenn die Datei über einen Typ verfügt, der durch den algorithmus bestimmt werden kann, der unter Registrieren eines benutzerdefinierten Dateityps beschrieben wird, wird die empfohlene Dateiquellfilter-CLSID verwendet, wenn der Filterdiagramm-Manager versucht, das Filterdiagramm zu rendern.

Wenn ein Filter den Namen einer Datei zum Öffnen benötigt, sollte er diese Schnittstelle verfügbar machen, damit eine Anwendung den Dateinamen festlegen kann. Beachten Sie, dass es keine Basisklassenimplementierung dieser Schnittstelle gibt.

Eine Anwendung, die Dateiquellfilter direkt einfügt, muss diese Schnittstelle abfragen und den Dateinamen festlegen. Normalerweise verwendet der Filterdiagramm-Manager diese Schnittstelle, wenn eine Anwendung IGraphBuilder::RenderFile aufruft. Das Graphedt.exe-Tool fragt die IFileSourceFilter-Schnittstelle ab und fordert einen Dateinamen an, wenn es ihn findet.

Vererbung

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

Methoden

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

 
IFileSourceFilter::GetCurFile

Die GetCurFile-Methode ruft den Namen und den Medientyp der aktuellen Datei ab. (IFileSourceFilter.GetCurFile)
IFileSourceFilter::Load

Die Load-Methode bewirkt, dass ein Quellfilter eine Mediendatei lädt.

Anforderungen

   
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)