通过

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 与属性类型相关联。) 有关媒体基础属性及其数据类型的列表，请参阅 媒体基础属性。

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

  • Windows XP with Service Pack 2 (SP2) 及更高版本。
  • 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)
Library Mfuuid.lib

另请参阅

特性和属性

IMFAttributes