Freigeben über


IFileSinkFilter2-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 IFileSinkFilter2-Schnittstelle erweitert die IFileSinkFilter-Schnittstelle . Filter, die Mediendatenströme in eine Datei schreiben, implementieren diese Schnittstelle. Ein Dateisenkenfilter in einem Videoaufnahmefilterdiagramm speichert für instance die Ausgabe des Videokomprimierungsfilters in einer Datei. In der Regel sollte die Anwendung, die dieses Filterdiagramm ausführt, dem Benutzer ermöglichen, den Namen der Datei einzugeben, in der die Daten gespeichert werden sollen. Mit dieser Schnittstelle können Sie diese Informationen kommunizieren.

IFileSinkFilter2 fügt die Option hinzu, um zu bestimmen, ob die von ihr geschriebene Datei eine vorhandene Datei mit demselben Namen zerstören soll. Im Fall der Videoaufnahme sollten Sie eine datei, die Sie bereits erstellt haben, nicht zerstören, da das Vorabzuweisen von Dateispeicherplatz wertvolle Zeit in Anspruch nimmt. Standardmäßig zerstört die neue Datei nicht die alte Datei. Zerstören Sie andernfalls die ursprüngliche Datei, um sicherzustellen, dass die von Ihnen erstellte Datei keinen Müll enthält.

Vererbung

Die IFileSinkFilter2-Schnittstelle erbt von IFileSinkFilter. IFileSinkFilter2 verfügt auch über folgende Membertypen:

Methoden

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

 
IFileSinkFilter2::GetMode

Die GetMode-Methode ruft ab, ob der Dateiwriter die Datei beim Erstellen der neuen Datei zerstört.
IFileSinkFilter2::SetMode

Die SetMode-Methode bestimmt, ob der Dateischreiber die Datei beim Erstellen der neuen Datei zerstört.

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

IFileSinkFilter

Schnittstellen