IFileSinkFilter::SetFileName-Methode (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 SetFileName -Methode legt den Namen der Datei fest, in die Medienbeispiele geschrieben werden.

Syntax

HRESULT SetFileName(
  [in] LPCOLESTR           pszFileName,
  [in] const AM_MEDIA_TYPE *pmt
);

Parameter

[in] pszFileName

Zeiger auf den Namen der Datei, die die Medienbeispiele empfangen soll.

[in] pmt

Zeiger auf den Typ der Medienbeispiele, die in die Datei geschrieben werden sollen, und den Medientyp des Eingabenadels des Senkenfilters.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Wenn der pszFileName-Parameter eine nicht vorhandene Datei benennt, wird die Datei erstellt. Wenn eine vorhandene Datei benennt, überschreibt der Senkenfilter die Datei, ohne sie zuvor zu löschen.

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

Siehe auch

Fehler- und Erfolgscodes

IFileSinkFilter-Schnittstelle

IFileSinkFilter2