IPropertySetter::CloneProps 方法

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

注意

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

 

方法 CloneProps 从此属性资源库克隆一组属性,并将其添加到新的属性资源库。

语法

HRESULT CloneProps(
  [out] IPropertySetter **ppSetter,
  [in]  REFERENCE_TIME  rtStart,
  [in]  REFERENCE_TIME  rtStop
);

参数

ppSetter [out]

接收指向新属性 资源库的 IPropertySetter 接口的指针。

rtStart [in]

要克隆的值范围的开始时间,以 100 纳秒为单位。

rtStop [in]

保留。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

备注

仅克隆指定开始时间之后的值。 然后,克隆值上的时间相对于开始时间进行调整。 例如,如果 rtStart) 为 20000000 (2 秒,则时间为 300000000 (3 秒的值) 克隆时间为 100000000 (1 秒) 。 最后,为每个克隆的属性提供一个初始值,该值等于起始时间的原始属性的值, (在必要时正确内插) 。 实际上,属性数据在指定的开始时间被拆分。

如果该方法成功,则它返回的 IPropertySetter 接口具有未完成的引用计数。 使用完接口后,请务必释放它。

注意

头文件 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

另请参阅

IPropertySetter 接口

错误和成功代码