通过

IDvdControl2：：SetSubpictureState 方法 (strmif.h)

  • 项目

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

方法 SetSubpictureState 打开或关闭子图片显示。

语法

HRESULT SetSubpictureState(
  [in]  BOOL    bState,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

参数

[in] bState

指定子图片显示是否打开的布尔值; TRUE 设置子图片显示，以便进行后续播放。

[in] dwFlags

DVD_CMD_FLAGS枚举中的一个或多个标志的按位 OR，指定如何同步命令。

[out] ppCmd

接收指向可用于同步 DVD 命令的 IDvdCmd 对象的指针。 调用方必须释放接口。 此参数可以为 NULL。 有关详细信息，请参阅 同步 DVD 命令。

返回值

返回以下值之一。

返回代码 说明
S_OK
 成功。
VFW_E_DVD_INVALIDDOMAIN
 DVD 导航器位于“第一个播放”域中。
VFW_E_DVD_OPERATION_INHIBITED
 UOP 控制禁止此操作。

注解

子图片流通常用于按钮文本（有时是按钮图形）的菜单，以及字幕、信用或其他叠加图形的视频播放。 不要将子图片与隐藏式字幕混淆;后者在视频流中编码。 一般情况下，此方法用于在 DVD 导航器筛选器在 DVD 标题域中播放视频时控制视频上的子图片显示。

此方法对应于附件 J“Sub-picture_Stream_Change”命令的第二个参数。

下表显示了此方法名称对应的附件 J 命令名称，以及此方法的有效域。

附件 J 命令名称 有效域
子picture_stream_Change
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title
  • DVD_DOMAIN_Stop

要求

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

另请参阅

DVD 应用程序

错误和成功代码

IDvdControl2 接口

SelectSubpictureStream