Freigeben über

IFileSinkFilter::GetCurFile-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.]

Die GetCurFile -Methode ruft den Namen und den Medientyp der aktuellen Datei ab.

Syntax

HRESULT GetCurFile(
  [out] LPOLESTR      *ppszFileName,
  [out] AM_MEDIA_TYPE *pmt
);

Parameter

[out] ppszFileName

Adresse eines Zeigers, der den Namen der Datei als OLESTR-Typ empfängt.

[out] pmt

Zeiger auf eine AM_MEDIA_TYPE Struktur, die den Medientyp empfängt. Dieser Parameter kann null sein. In diesem Fall gibt die Methode nicht den Medientyp zurück.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
S_OK
 Erfolg.
E_FAIL
 Es wird keine Datei geöffnet.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.
E_POINTER
 NULL-Zeigerargument in ppszFileName.

Bemerkungen

Wenn der Filter keine Datei geöffnet hat, kann die Methode erfolgreich sein, gibt aber null im ppszFileName-Parameter zurück. Überprüfen Sie den Wert, wenn die Methode zurückgibt.

Die -Methode ordnet den Arbeitsspeicher für die in ppszFileName zurückgegebene Zeichenfolge und den Arbeitsspeicher für den Formatblock im Medientyp zu (falls vorhanden). Der Aufrufer muss sie durch Aufrufen von CoTaskMemFree freigeben. Für den Medientyp können Sie die Funktion FreeMediaType in der Basisklassenbibliothek verwenden.

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