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 |