Метод IMFAttributes::SetItem (mfobjects.h)

  • Статья

Добавляет значение атрибута с указанным ключом.

Синтаксис

HRESULT SetItem(
  [in] REFGUID        guidKey,
  [in] REFPROPVARIANT Value
);

Параметры

[in] guidKey

Идентификатор GUID, определяющий устанавливаемое значение. Если этот ключ уже существует, метод перезаписывает старое значение.

[in] Value

Объект PROPVARIANT, содержащий значение атрибута. Метод копирует значение . Тип PROPVARIANT должен быть одним из типов, перечисленных в перечислении MF_ATTRIBUTE_TYPE .

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_OUTOFMEMORY
 Недостаточно памяти.
MF_E_INVALIDTYPE
 Недопустимый тип атрибута.

Комментарии

Этот метод проверяет, является ли тип PROPVARIANT одним из типов атрибутов, определенных в MF_ATTRIBUTE_TYPE, и завершается ошибкой, если используется неподдерживаемый тип. Однако этот метод не проверка, является ли PROPVARIANT правильным типом для указанного GUID атрибута. (Программный способ связать идентификаторы GUID атрибутов с типами свойств не существует.) Список атрибутов Media Foundation и их типов данных см. в разделе Атрибуты Media Foundation.

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media Format 11:

  • Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
  • Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfobjects.h (включая Mfidl.h)
Библиотека Mfuuid.lib

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

Атрибуты и свойства

IMFAttributes