IPropertySetter 接口

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意

[已弃用。 此 API 可能会从 Windows 的未来版本中删除。]

 

接口 IPropertySetter 在 DirectShow Editing Services (DES) 中设置效果或转换的属性。

若要使用此接口，请 (CLSID_PropertySetter) 创建属性资源库对象的实例，并通过调用 IAMTimelineObj：：SetPropertySetter 方法将其与效果或转换相关联。 有关详细信息，请参阅 使用效果和过渡。

通常，应用程序只需调用 IPropertySetter：：ClearProps 方法来清除现有属性，并调用 IPropertySetter：：AddProp 方法即可添加新属性。 此接口上的其他方法由其他 DES 组件调用。

成员

IPropertySetter 接口继承自 IUnknown 接口。 IPropertySetter 还具有以下类型的成员：

• 方法

方法

IPropertySetter 接口具有以下方法。

方法	说明
AddProp	将属性添加到属性资源库，其中包含一个时间值对数组，用于定义属性在一段时间内的值。
ClearProps	从属性资源库清除所有属性数据。
CloneProps	从此属性资源库克隆一组属性，并将其添加到新的属性资源库。
FreeProps	释放 由 IPropertySetter：：GetProps 方法分配的资源。
GetProps	检索在此对象上设置的属性及其相应的值。
LoadFromBlob	从持久性格式加载属性数据。
LoadXML	加载以可扩展标记语言 (XML) 表示的属性数据。
PrintXML	将属性数据转换为 XML 字符串。
SaveToBlob	将属性数据保存为持久性格式。
SetProps	将目标对象的属性设置为指定时间的相应状态。

 

备注

注意

头文件 Qedit.h 与版本 7 之后的 Direct3D 标头不兼容。

 

注意

若要获取 Qedit.h，请下载适用于 Windows Vista 和 .NET Framework 3.0 的Microsoft Windows SDK更新。 Qedit.h 在 Windows 7 和 .NET Framework 3.5 Service Pack 1 的Microsoft Windows SDK中不可用。

 

要求

要求	值
标头	Qedit.h
库	Strmiids.lib