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


Интерфейс IMediaPropertyBag (strmif.h)

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

Интерфейс IMediaPropertyBag предоставляется объектом Media Property Bag . Контейнер свойств мультимедиа — это специализированная версия стандартного контейнера свойств COM, предназначенная для установки и извлечения блоков INFO и DISP в Audio-Video файлах с чередованием (AVI).

Блок INFO содержит метаданные о файле, например сведения об авторе и авторских правах. Блок DISP содержит данные в формате буфера обмена. Дополнительные сведения см. в спецификации формата RIFF.

В контейнере свойств мультимедиа блоки хранятся в виде пар "имя-значение", как показано ниже.

  • Блоки INFO. Имя представляет собой строку в форме INFO/XXXX, где XXXX — это четырехзначный код, определяющий тип метаинформации, например ICOP для информации об авторских правах и IART для имени автора. Значением является любая строка.
  • Фрагменты DISP. Имя представляет собой строку в формате DISP/00000000000, где 00000000000 — это десятичный 10-значный десятичный эквивалент стандартного формата буфера обмена, например 0000000008 для CF_DIB. Значение представляет собой массив байтов, содержащий отображаемые данные.
Используйте этот интерфейс с интерфейсом IPersistMediaPropertyBag для получения блоков INFO и DISP из AVI-файла.

Наследование

Интерфейс IMediaPropertyBag наследуется от IPropertyBag. IMediaPropertyBag также имеет следующие типы элементов:

Методы

Интерфейс IMediaPropertyBag содержит следующие методы.

 
IMediaPropertyBag::EnumProperty

Метод EnumProperty извлекает пару "свойство-значение".

Требования

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