Share via

IAMExtTransport：：SetTransportBasicParameters 方法 (strmif.h)

  • 项目

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

方法 SetTransportBasicParameters 设置传输的常规属性。

语法

HRESULT SetTransportBasicParameters(
  [in] long      Param,
  [in] long      Value,
  [in] LPCOLESTR pszData
);

参数

[in] Param

指定要设置的属性。 有关更多信息，请参见备注。

[in] Value

将 属性的值指定为 长 整数。 有关更多信息，请参见备注。

[in] pszData

将 属性的值指定为 LPOLESTR。 有关更多信息，请参见备注。

返回值

此方法成功后，将返回S_OK。 否则，它将返回 HRESULT 错误代码。 可能的错误代码包括以下内容。

返回代码 说明
E_NOTIMPL
 设备不支持设置此属性。
ERROR_DEVICE_REMOVED
 设备已删除。

注解

Param 参数是指定要设置的属性的标志。 对于某些标志， 属性为数值;使用 Value 参数指定值。 对于其他标志， 属性是字符串;使用 pszData 参数指定值。 在任一情况下， 方法都忽略另一个参数。

对于以下标志， Value 参数采用定义的常量。

  • ED_TRANSBASIC_TIME_FORMAT：指定时间格式。
    一直 说明
    ED_FORMAT_MILLISECONDS 几毫秒。
    ED_FORMAT_FRAMES 框架。
    ED_FORMAT_REFERENCE_TIME 参考时间。
    ED_FORMAT_HMSF 二进制编码的十进制，表示小时、分钟、秒和帧。
    ED_FORMAT_TMSF 二进制编码的十进制，表示轨道、分钟、秒和帧。
     
  • ED_TRANSBASIC_TIME_REFERENCE：指定设备使用的引用时间。
    一直 说明
    ED_TIMEREF_TIMECODE 时间代码。
    ED_TIMEREF_CONTROL_TRACK 控制轨道。
    ED_TIMEREF_INDEX Index。
    ED_TIMEREF_ATN 绝对跟踪数。 此常量在头文件 Xprtdefs.h 中定义。
     
  • ED_TRANSBASIC_END_STOP_ACTION：指定设备到达传输介质末尾时执行的操作。
    一直 说明
    ED_MODE_STOP 停止。
    ED_MODE_REWIND 倒。
    ED_MODE_FREEZE 冻结/暂停。
     
  • ED_TRANSBASIC_RECORD_FORMAT：指定录制速度。
    一直 说明
    ED_RECORD_FORMAT_SP 标准游戏。
    ED_RECORD_FORMAT_LP 长玩。
    ED_RECORD_FORMAT_EP 扩展播放。
     
  • ED_TRANSBASIC_SUPERIMPOSE：指定是启用或禁用屏幕显示。
    一直 说明
    OATRUE 已启用屏幕显示。
    OAFALSE 屏幕显示已禁用。
     
  • ED_TRANSBASIC_STEP_UNIT：指定步骤单位。
    一直 说明
    ED_STEP_FIELD 字段。
    ED_STEP_FRAME 框架。
    ED_STEP_3_2 3/2 下拉。
     
  • ED_TRANSBASIC_SET_COUNTER_FORMAT：设置计数器的时间格式。 有关可能的值，请参阅ED_TRANSBASIC_TIME_FORMAT标志。
对于以下标志，请在 Value 参数中使用数值。
标志 描述
ED_TRANSBASIC_STEP_COUNT 指定步长计数，以ED_TRANSBASIC_STEP_UNIT标志定义的单位为单位。
ED_TRANSBASIC_SET_FREEZE_TIMEOUT 指定冻结模式的超时，以当前时间格式的单位为单位。
ED_TRANSBASIC_SETCLOCK 设置时钟时间。
ED_TRANSBASIC_SET_COUNTER_VALUE 设置计数器的值。
 

对于以下标志，请在 pszData 参数中使用字符串。

标志 描述
ED_TRANSBASIC_VOLUME_NAME 指定卷名称。
 

DV 实现

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

要求

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

另请参阅

错误和成功代码

IAMExtTransport 接口

IAMExtTransport：：GetTransportBasicParameters