IMFAttributes 接口 (mfobjects.h)

提供在对象上存储键/值对的通用方法。 键是 GUID，值可以是以下任一数据类型： UINT32、 UINT64、 double、 GUID、宽字符字符串、字节数组或 IUnknown 指针。 此接口的标准实现在添加、删除或检索值时保留线程锁。

有关预定义属性 GUID的列表，请参阅 媒体基础属性。 每个属性 GUID 都具有预期的数据类型。 IMFAttributes 中的各种“set”方法不会根据属性 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 检索与键关联的双精度值。
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 将双精度值与键相关联。
IMFAttributes：：SetGUID 将 GUID 值与键相关联。
IMFAttributes：：SetItem 添加具有指定键的属性值。
IMFAttributes：：SetString 将宽字符字符串与键相关联。
IMFAttributes：：SetUINT32 将 UINT32 值与键相关联。
IMFAttributes：：SetUINT64 将 UINT64 值与键相关联。
IMFAttributes：：SetUnknown 将 IUnknown 指针与键相关联。
IMFAttributes：：UnlockStore 在调用 IMFAttributes：：LockStore 方法后解锁属性存储。 当对象处于解锁状态时，多个线程可以访问对象的属性。

注解

如果安装了 Windows Media Format 11 SDK 可再发行组件，则此接口在以下平台上可用：

• 具有 Service Pack 2 的 Windows XP (SP2) 及更高版本。
• 安装 windows XP Media Center Edition 2005) 的 Windows XP Media Center Edition 2005 (KB900325 (Windows XP Media Center Edition 2005) 和 KB925766 (2006 年 10 月更新汇总 windows XP Media Center Edition) 。

要求

最低受支持的客户端	Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 | UWP 应用]
目标平台	Windows
标头	mfobjects.h (包括 Mfidl.h)

另请参阅

属性和属性

媒体基础接口