IFileSinkFilter-Schnittstelle (strmif.h)
[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 IFileSinkFilter Schnittstelle wird für Filter implementiert, die Mediendatenströme in eine Datei schreiben. Ein Dateisenkenfilter in einem Videoaufnahmefilterdiagramm schreibt für instance die Ausgabe des Videokomprimierungsfilters in eine Datei. In der Regel sollte die Anwendung, die dieses Filterdiagramm ausführt, es dem Benutzer ermöglichen, den Namen der Datei einzugeben, in die geschrieben werden soll. Diese Schnittstelle ermöglicht die Kommunikation dieser Informationen.
Wenn ein Filter den Namen einer Ausgabedatei benötigt, sollte er diese Schnittstelle verfügbar machen, damit eine Anwendung den Dateinamen festlegen kann. Beachten Sie, dass es derzeit keine Basisklassenimplementierung dieser Schnittstelle gibt.
Jede Anwendung, die den Namen der Datei festlegen muss, in die der Dateisenkenfilter schreibt, sollte diese Schnittstelle verwenden, um den Dateinamen abzurufen und festzulegen.
Vererbung
Die IFileSinkFilter-Schnittstelle erbt von der IUnknown-Schnittstelle . IFileSinkFilter verfügt auch über folgende Membertypen:
Methoden
Die IFileSinkFilter-Schnittstelle verfügt über diese Methoden.
| IFileSinkFilter::GetCurFile Die GetCurFile-Methode ruft den Namen und den Medientyp der aktuellen Datei ab. (IFileSinkFilter.GetCurFile) |
| IFileSinkFilter::SetFileName Die SetFileName-Methode legt den Namen der Datei fest, in die Medienbeispiele geschrieben werden. |
Hinweise
Die IFileSinkFilter2-Schnittstelle erweitert IFileSinkFilter.
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) |