IAMExtTransport::SetEditPropertySet 方法 (strmif.h)

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

方法 SetEditPropertySet 注册描述一组编辑属性的编辑属性集。

未实现此方法。

语法

HRESULT SetEditPropertySet(
  [in, out] long *pEditID,
  [in]      long State
);

参数

[in, out] pEditID

指向指定或接收编辑属性集标识符的 整数的指针。

[in] State

指定编辑属性集的状态。

说明
ED_ACTIVE 激活编辑属性集。
ED_DELETE 删除编辑属性集。
ED_INACTIVE 停用编辑属性集。
ED_REGISTER 注册编辑属性集。
 

如果值为 ED_REGISTER,则 pEditID 参数将接收编辑属性集的标识符。 对于其他标志,请使用 pEditID 参数指定标识符。

返回值

此方法成功后,将返回S_OK。 否则,它将返回 HRESULT 错误代码。

注解

编辑事件是定义录制序列的一组参数。 例如,参数可以指定编辑模式、内点和输出点或查找位置。 每个编辑事件由一个或多个参数组成,称为 编辑属性。 属性集合称为 编辑属性集。 每个编辑属性集都由设备筛选器分配的 整数标识。

若要创建和执行编辑事件,应用程序必须执行以下操作:

  • 注册编辑属性集。 SetEditPropertySet使用 State 参数中的值ED_REGISTER调用 方法。 当方法返回时, pEditID 参数包含编辑属性集的标识符。 使用此数字标识在后续方法调用中设置的 edit 属性。
  • 使用 IAMExtTransport::SetEditProperty 方法指定编辑属性。
  • 通过使用 值ED_ACTIVE调用 SetEditPropertySet 来激活 edit 事件。
  • 通过使用值 ED_EDIT_SEEK 调用 SetEditProperty 来提示传输。
  • 运行筛选器图。
例如,以下代码在所有轨道上配置插入编辑:
C++
注册编辑属性集 ID。  (导致分配内存。) 长 EditId;SetEditPropertySet (&EditId,ED_REGISTER) ;

设置编辑模式。 SetEditProperty (EditId、ED_EDIT_MODE、ED_EDIT_MODE_INSERT) ;设置有关事件的详细信息。 SetEditProperty (EditId、ED_EDIT_TRACK、ED_VIDEO |ED_AUDIO_ALL) ;SetEditProperty (EditId、ED_REHEARSE_MODE、ED_EDIT_PERFORM) ;

设置源和记录时间。 SetEditProperty (EditId, ED_EDIT_SRC_INPOINT, 200) SetEditProperty (EditId, ED_EDIT_SRC_OUTPOINT, 500) SetEditProperty (EditId, ED_EDIT_REC_INPOINT, 100) SetEditProperty (EditId, ED_EDIT_REC_OUTPOINT, 400)

激活编辑事件。 SetEditPropertySet (&EditId, ED_ACTIVE) ;提示计算机。 SetEditProperty (EditId、ED_EDIT_SEEK、OATRUE) ;

// Run the graph. (Not shown.)

DV 实现

MSDV 不支持此方法。 它返回E_NOTIMPL。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IAMExtTransport 接口

IAMExtTransport::GetEditPropertySet