IDvdInfo2::GetCurrentSubpicture 方法 (strmif.h)

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

方法 GetCurrentSubpicture 检索当前标题中可用子图片流的数量、当前所选子图片流编号和子图片的状态。

语法

HRESULT GetCurrentSubpicture(
  [out] ULONG *pulStreamsAvailable,
  [out] ULONG *pulCurrentStream,
  [out] BOOL  *pbIsDisabled
);

参数

[out] pulStreamsAvailable

接收可用子图片流的数量。

[out] pulCurrentStream

接收当前所选子图片流的编号。

[out] pbIsDisabled

接收一个布尔值,该值指示是否禁用子图片显示; TRUE 表示它已禁用。

返回值

返回以下 HRESULT 值之一。

返回代码 说明
S_OK
成功。
E_POINTER
无效的参数。
VFW_E_DVD_INVALIDDOMAIN
DVD 导航器未初始化或未在标题域中。

注解

DVD 内容作者可以指定强制激活光盘上的任何特定子图片流,这意味着 DVD 作者需要此流来显示观看者是否要watch该流。 DVD 导航器符合光盘中的所有此类命令,这意味着即使应用程序使用 IDvdControl2::SetSubpictureState 方法禁用了子图片显示,也会显示强制激活的流。

要求

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

另请参阅

DVD 应用程序

EC_DVD_SUBPICTURE_STREAM_CHANGE

错误和成功代码

IDvdInfo2 接口