IFileSourceFilter::Load-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 Load -Methode bewirkt, dass ein Quellfilter eine Mediendatei lädt.

Syntax

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

Parameter

[in] pszFileName

Zeiger auf den Namen der zu öffnenden Datei.

[in] pmt

Zeiger auf den Medientyp der Datei. Dies kann NULL sein.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Diese Methode initialisiert die -Schnittstelle. Es ist nicht zum Laden mehrerer Dateien konzipiert, und alle Aufrufe dieser Methode nach dem ersten Aufruf schlagen fehl.

Für den Filter Dateiquelle (Async) gibt pszFileName den absoluten Pfadnamen einer lokalen Datei an. Für den Filter Dateiquelle (URL) gibt pszFileName die URL einer Datei an, die heruntergeladen werden soll. Für andere Filterimplementierungen erfordert pszFileName je nach Filter möglicherweise einen Dateinamen oder eine URL.

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

IFileSourceFilter-Schnittstelle