Интерфейс IMFAttributes (mfobjects.h)

Предоставляет универсальный способ хранения пар "ключ-значение" в объекте . Ключами являются GUID, и значения могут иметь любой из следующих типов данных: UINT32, UINT64, double, GUID, строка расширенных символов, массив байтов или указатель IUnknown . Стандартная реализация этого интерфейса удерживает блокировку потока при добавлении, удалении или извлечении значений.

Список стандартных GUIDатрибутов см. в разделе Атрибуты Media Foundation. Каждый GUID атрибута имеет ожидаемый тип данных. Различные методы set в IMFAttributes не проверяют тип по идентификатору GUID атрибута. Приложение отвечает за определение правильного типа атрибута.

Чтобы создать пустое хранилище атрибутов, вызовите MFCreateAttributes.

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

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

Методы

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

IMFAttributes::Compare Сравнивает атрибуты этого объекта с атрибутами другого объекта.
IMFAttributes::CompareItem Запрашивает, равно ли значение сохраненного атрибута указанному PROPVARIANT.
IMFAttributes::CopyAllItems Копирует все атрибуты из этого объекта в другое хранилище атрибутов.
IMFAttributes::D eleteAllItems Удаляет все пары "ключ-значение" из списка атрибутов объекта.
IMFAttributes::D eleteItem Удаляет пару "ключ-значение" из списка атрибутов объекта.
IMFAttributes::GetAllocatedBlob Извлекает массив байтов, связанный с ключом. Этот метод выделяет память для массива.
IMFAttributes::GetAllocatedString Возвращает строку расширенных символов, связанную с ключом. Этот метод выделяет память для строки.
IMFAttributes::GetBlob Извлекает массив байтов, связанный с ключом. Этот метод копирует массив в буфер, выделенный вызывающим объектом.
IMFAttributes::GetBlobSize Извлекает длину массива байтов, связанного с ключом.
IMFAttributes::GetCount Извлекает количество атрибутов, заданных для этого объекта.
IMFAttributes::GetDouble Извлекает значение типа double, связанное с ключом.
IMFAttributes::GetGUID Извлекает значение GUID, связанное с ключом.
IMFAttributes::GetItem Извлекает значение, связанное с ключом.
IMFAttributes::GetItemByIndex Извлекает атрибут по указанному индексу.
IMFAttributes::GetItemType Извлекает тип данных значения, связанного с ключом.
IMFAttributes::GetString Извлекает строку расширенных символов, связанную с ключом.
IMFAttributes::GetStringLength Извлекает длину строкового значения, связанного с ключом.
IMFAttributes::GetUINT32 Извлекает значение UINT32, связанное с ключом.
IMFAttributes::GetUINT64 Извлекает значение UINT64, связанное с ключом.
IMFAttributes::GetUnknown Извлекает указатель интерфейса, связанный с ключом.
IMFAttributes::LockStore Блокирует хранилище атрибутов, чтобы другие потоки не могли получить к нему доступ.
IMFAttributes::SetBlob Связывает массив байтов с ключом.
IMFAttributes::SetDouble Связывает значение типа double с ключом.
IMFAttributes::SetGUID Связывает значение GUID с ключом.
IMFAttributes::SetItem Добавляет значение атрибута с указанным ключом.
IMFAttributes::SetString Связывает строку расширенных символов с ключом.
IMFAttributes::SetUINT32 Связывает значение UINT32 с ключом.
IMFAttributes::SetUINT64 Связывает значение UINT64 с ключом.
IMFAttributes::SetUnknown Связывает указатель IUnknown с ключом.
IMFAttributes::UnlockStore Разблокирует хранилище атрибутов после вызова метода IMFAttributes::LockStore. Пока объект разблокирован, несколько потоков могут получить доступ к атрибутам объекта.

Комментарии

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

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

Требования

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

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

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

Интерфейсы Media Foundation