Метод IFileSourceFilter::Load (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод Load приводит к загрузке файла мультимедиа с помощью фильтра источника.
Синтаксис
HRESULT Load(
[in] LPCOLESTR pszFileName,
[in] const AM_MEDIA_TYPE *pmt
);
Параметры
[in] pszFileName
Указатель на имя открываемого файла.
[in] pmt
Указатель на тип носителя файла. Это может быть значение NULL.
Возвращаемое значение
Возвращает значение HRESULT .
Комментарии
Этот метод инициализирует интерфейс . Он не предназначен для загрузки нескольких файлов, и любые вызовы этого метода после первого вызова завершаются ошибкой.
Для фильтра Источник файла (асинхронный)pszFileName указывает абсолютный путь к локальному файлу. Для фильтра Источник файла (URL-адрес)pszFileName указывает URL-адрес загружаемого файла. Для других реализаций фильтра для pszFileName может потребоваться имя файла или URL-адрес в зависимости от фильтра.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |