IDvdControl2：:P layChaptersAutoStop 方法 (strmif.h)

2024-03-02

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

方法 PlayChaptersAutoStop 播放指定的章节数，从指定标题中的指定章节开始。

语法

HRESULT PlayChaptersAutoStop(
  [in]  ULONG   ulTitle,
  [in]  ULONG   ulChapter,
  [in]  ULONG   ulChaptersToPlay,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

参数

[in] ulTitle

指定章节所在标题的值;此值必须介于 1 到 99。

[in] ulChapter

一个值，该值指定 DVD 导航器将开始播放的指定标题中的章节;此值必须介于 1 到 999。

[in] ulChaptersToPlay

从开始章节开始播放的章节数。

[in] dwFlags

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

[out] ppCmd

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

返回值

返回以下值之一。

返回代码	说明
S_OK	成功。
E_UNEXPECTED	DVD 导航器未初始化，或者游戏不是单顺序 PGC 游戏。
E_INVALIDARG	ulTitle 值不存在或大于标题数，或 ulChapter 不存在或大于章节数，或者 ulChapter 加 ulChaptersToPlay 大于章节数。
VFW_E_DVD_GRAPHNOTREADY	图形未处于运行状态。

注解

此方法仅适用于One_Sequential_PGC_Titles。播放指定数量的章节后，DVD 导航器会向应用程序发送 EC_DVD_CHAPTER_AUTOSTOP 事件通知。

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

附件 J 命令名称	有效域
无。	全部。

要求

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