Поделиться через

Метод IPersistMediaPropertyBag::Save (strmif.h)

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод Save сохраняет свойства из фильтра в контейнер свойств мультимедиа.

Синтаксис

HRESULT Save(
  [in] IMediaPropertyBag *pPropBag,
  [in] BOOL              fClearDirty,
  [in] BOOL              fSaveAllProperties
);

Параметры

[in] pPropBag

Указатель на интерфейс IMediaPropertyBag контейнера свойств мультимедиа, созданного вызывающим элементом.

[in] fClearDirty

Зарезервировано. Может быть любым значением.

[in] fSaveAllProperties

Зарезервировано. Может быть любым значением.

Возвращаемое значение

Возвращает значение HRESULT . Возможные значения:

Код возврата Описание
S_OK
 Успешно.
E_NOTIMPL
 Не реализован.
E_OUTOFMEMORY
 Недостаточно памяти.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
 Недопустимые данные.

Комментарии

При вызове этого метода в фильтре разделителя AVI или средстве синтаксического анализа WAVE фильтр считывает все блоки INFO и DISP из файла и сохраняет их в контейнере свойств мультимедиа. Для получения фрагментов можно использовать метод IMediaPropertyBag::EnumProperty .

Фильтр AVI Mux не реализует этот метод.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

См. также раздел

Коды ошибок и успешности

Интерфейс IPersistMediaPropertyBag