MSWebDVD 对象
[与此页面关联的功能（DirectShow）是一项旧功能。 它已被 MediaPlayer、IMFMediaEngine取代，并在媒体基金会 音频/视频捕获。 这些功能已针对 Windows 10 和 Windows 11 进行了优化。 Microsoft强烈建议新代码尽可能使用 MediaPlayer、IMFMediaEngine 和 Media Foundation 中的音频/视频捕获，而不是 DirectShow。 Microsoft建议重写使用旧 API 的现有代码，以尽可能使用新 API。]
注意
此组件可用于 Microsoft Windows 2000、Windows XP 和 Windows Server 2003作系统。 在后续版本中可能会更改或不可用。
注意
此 API 已弃用。 有关 DirectShow 中的 DVD 播放和导航的信息，请参阅 DVD 应用程序。
MSWebDVD 对象的方法、属性和事件使应用程序能够控制 DVD-Video 导航和播放的所有方面，以及从光盘检索信息。MSWebDVD 对象不执行实际导航工作;而是将命令传递给 DVD 导航器 筛选器，这是读取 DVD-Video 光盘的 Microsoft® DirectShow® 组件。
MSWeb DVD 方法和属性对 DVD 导航器的当前状态或光盘上的信息或两者的信息进行作。 若要在注册表中存储和检索各种类型的应用程序特定信息，例如家长级别的用户首选项和默认语言，请使用 MSDVDAdm 对象的方法。 使用 DVDAdm 属性访问此对象。
注意
从 DirectX 9.0b 开始，该对象仅在受信任的区域中加载。 它不会加载到不受信任的区域中。
按类别 方法和属性
| 回放 | |
|---|---|
| CanStep | 确定本地系统上的 MPEG-2 解码器是否可以按指定方向执行帧单步执行。 |
| 弹出 | 从驱动器或驱动器中弹出或插入光盘。 |
| FramesPerSecond | 检索当前 DVD 游戏的视频帧速率。 |
| 暂停 | 暂停当前位置的播放。 |
| Play | 播放当前的 DVD 标题。 |
| PlayAtTime | 在指定时间开始在当前标题中播放。 |
| PlayAtTimeInTitle | 在指定标题内的指定时间开始播放。 |
| PlayBackwards | 以指定的速度从当前位置开始向后播放。 |
| PlayChapter | 从当前标题中的指定章节开始播放。 |
| PlayChapterInTitle | 在指定标题中播放指定的章节。 |
| PlayChaptersAutoStop | 开始在指定标题的指定章节中播放指定章节的数目。 |
| PlayForwards | 以指定的速度从当前位置开始转发播放。 |
| PlayNextChapter | 从当前标题的下一章开始播放。 |
| PlayPeriodInTitleAutoStop | 在指定游戏的指定时间开始播放，直到指定的停止时间。 |
| PlayPrevChapter | 从当前标题中的上一章开始播放。 |
| PlayTitle | 在指定标题的开头开始播放。 |
| ReplayChapter | 在当前章节的开头开始播放。 |
| 恢复 | 在显示菜单后恢复播放。 |
| StillOff | 恢复播放，取消静止模式。 |
| 步骤 | 按指定的帧数推进 DVD-Video 流。 |
| 停止 | 停止播放。 |
| 菜单 | |
| ActivateAtPosition | 激活位于指定位置的菜单按钮。 |
| ActivateButton | 激活所选菜单按钮。 |
| ButtonsAvailable | 检索当前菜单上的按钮总数。 |
| CurrentButton | 检索所选按钮的数量。 |
| DefaultMenuLanguage | 从光盘检索默认菜单语言。 |
| GetButtonAtPosition | 检索指定坐标处的按钮编号，而无需选择或激活它。 |
| GetButtonRect | 在窗口坐标中检索指定按钮的矩形。 |
| ReturnFromSubmenu | 返回从子菜单到其父菜单的显示;如果菜单是顶级菜单，则返回当前标题。 |
| SelectAndActivateButton | 选择并激活指定的按钮。 |
| SelectAtPosition | 选择位于指定位置的菜单按钮。 |
| SelectLeftButton | 从显示的菜单中选择左侧方向按钮。 |
| SelectLowerButton | 从显示的菜单中选择下部方向按钮。 |
| SelectRightButton | 从显示的菜单中选择右方向按钮。 |
| SelectUpperButton | 从显示的菜单中选择上部方向按钮。 |
| ShowMenu | 在屏幕上显示指定的菜单。 |
| 音频流 | |
| AudioStreamsAvailable | 检索当前游戏中可用的音频流数。 |
| 平衡 | 设置或检索音频流输出的扬声器平衡。 |
| CurrentAudioStream | 设置或检索启用的音频流的数量。 |
| DefaultAudioLanguage | 从光盘检索默认音频语言。 |
| DefaultAudioLanguageExt | 从光盘检索默认音频语言扩展。 |
| GetAudioLanguage | 检索一个字符串，该字符串指示指定音频流上可用的语言。 |
| IsAudioStreamEnabled | 检索一个值，该值指示指定的音频流是否在当前游戏中启用。 |
| 静音 | 打开或关闭音频流输出。 |
| SelectDefaultAudioLanguage | 在 DVD 导航器中设置当前的默认音频语言。 |
| 卷 | 设置或检索音频音量级别。 |
| 子图片流 | |
| CurrentSubpictureStream | 检索所选的子图片流。 |
| DefaultSubpictureLanguage | 从光盘检索默认的子图片语言。 |
| DefaultSubpictureLanguageExt | 从光盘检索默认的子图片语言扩展。 |
| GetSubpictureLanguage | 检索指定子图片流的语言。 |
| IsSubpictureStreamEnabled | 检索一个值，该值指示指定的子图片流是否在当前游戏中启用。 |
| PreferredSubpictureStream | 设置或检索当前查看会话的用户首选子图片流。 |
| SelectDefaultSubpictureLanguage | 在 DVD 导航器中设置当前的默认子图片语言。 |
| SubpictureOn | 设置或检索当前子图片状态（打开或关闭）。 |
| SubpictureStreamsAvailable | 检索当前标题中可用的子图片流数。 |
| 视频矩形 | |
| AspectRatio | 检索光盘上创作的当前视频流的纵横比。 |
| BackColor | 设置或检索在本机视频的纵横比与对象显示区域的纵横比不同时显示在视频矩形边缘的条形图的颜色。 |
| 捕获 | 当 MSWebDVD 对象处于无窗口模式时，从视频帧中捕获静止图像。 |
| FullScreenMode | 设置或检索一个值，该值指示显示器是否处于全屏模式。 |
| GetClipVideoRect | 检索为视频显示定义的剪辑矩形。 |
| GetVideoSize | 检索本机视频尺寸。 |
| SetClipVideoRect | 设置视频显示占用的剪辑矩形。 |
| 缩放 | 放大或缩小视频显示，以一组给定的屏幕坐标为中心。 |
| 隐藏式字幕 | |
| CCActive | 设置或检索隐藏式字幕的当前状态。 |
| ColorKey | 设置或检索隐藏式字幕中使用的颜色键。 |
| CurrentCCService | 设置或检索当前隐藏式字幕服务。 |
| 角度块 | |
| AnglesAvailable | 检索可用的角度数。 |
| CurrentAngle | 设置或检索角度块中的当前角度。 |
| 卡拉OK音频 | |
| GetKaraokeChannelAssignment | 检索一个值，该值指示卡拉OK通道如何分配给左右扬声器。 |
| GetKaraokeChannelContent | 检索一个值，该值指示指定流中指定卡拉OK通道中内容类型。 |
| 卡拉OKAudioPresentationMode | 设置或检索辅助卡拉OK通道的右左扬声器混合。 |
| 文本字符串 | |
| GetDVDTextLanguageLCID | 检索指定文本字符串块的区域设置标识符（LCID）。 |
| GetDVDTextNumberOfLanguages | 检索当前 DVD 目录中可用的文本语言数。 |
| GetDVDTextNumberOfStrings | 检索可用于指定语言的文本字符串数。 |
| GetDVDTextString | 从光盘中检索指定的文本字符串。 |
| GetDVDTextStringType | 检索一个值，该值指示指定 DVD 文本字符串中包含的信息类型。 |
| GetLangFromLangID | 在给定主语言标识符（ID）时检索人工可读字符串。 |
| 家长管理 | |
| AcceptParentalLevelChange | 指示 DVD 导航器接受或拒绝新的临时家长管理级别。 |
| GetPlayerParentalCountry | 检索 DVD 导航器中设置的当前国家/地区。 |
| GetPlayerParentalLevel | 检索 DVD 导航器中设置的家长管理级别。 |
| GetTitleParentalLevels | 检索指定游戏的家长管理级别。 |
| NotifyParentalLevelChange | 启用或禁用临时家长管理级别命令的事件处理。 |
| SelectParentalCountry | 为后续播放设置指定的家长国家/地区。 |
| SelectParentalLevel | 为后续播放设置指定的家长级别。 |
| 光盘信息 | |
| CurrentChapter | 检索当前正在播放的章节的数量。 |
| CurrentDiscSide | 检索 DVD 的当前端。 |
| CurrentDomain | 检索 DVD 导航器位于的 DVD 域。 |
| CurrentTime | 检索当前播放时间。 |
| CurrentTitle | 检索当前播放的游戏数。 |
| CurrentVolume | 检索当前根目录的卷号。 |
| DVDDirectory | 检索或设置当前 DVD 卷的根目录。 |
| DVDTimeCode2bstr | 检索一个字符串，指示光盘上的当前时间。 |
| DVDUniqueID | 检索唯一标识当前 DVD 的系统生成的数字。 |
| GetNumberOfChapters | 检索指定标题中的章节数。 |
| TitlesAvailable | 检索 DVD 上可用的游戏数。 |
| TotalTitleTime | 检索当前游戏的总播放时间。 |
| UOPValid | 检索一个值，该值指示指定的用户作当前是否有效。 |
| VolumesAvailable | 检索指定光盘集中卷数的值。 |
| 对象初始化和控制 | |
| DisableAutoMouseProcessing | 启用或禁用对象的鼠标处理功能。 |
| DVDAdm | 提供对 MSDVDAdm 对象的访问，该对象包含用于保存应用程序和用户信息的方法和属性。 |
| EnableResetOnStop | 设置或检索一个值，该值确定筛选器图从停止状态切换时如何恢复播放。 |
| PlayState | 检索当前播放状态。 |
| ReadyState | 检索 MSWebDVD 对象的 ReadyState。 |
| RegionChange | 显示一个系统对话框，使用户能够更改与 DVD 驱动器关联的区域。 |
| 呈现 | 初始化 DVD 筛选器图。 |
| WindowlessActivation | 在设计时为窗口模式或无窗口模式初始化 MSWebDVD 对象。 |
| 书签 | |
| DeleteBookmark | 删除当前书签。 |
| RestoreBookmark | 将 DVD 导航器移动到当前书签中指定的 DVD 上的点，并还原了所有音频、视频和子图片设置。 |
| SaveBookmark | 将 DVD 导航器的当前光盘位置和状态保存到光盘，以便用户以后可以返回到同一位置。 |
| 游标和工具提示 | |
| CursorType | 设置或检索当前游标类型。 |
| GetDelayTime | 检索与 MSWebDVD 对象关联的工具提示的延迟时间。 |
| SetDelayTime | 设置与 MSWebDVD 对象关联的工具提示的延迟时间。 |
| ShowCursor | 当 DVD 导航器处于全屏模式时，使鼠标指针可见。 |
| 工具提示 | 设置当鼠标指针位于 MSWebDVD 视频矩形上时将显示的工具提示的文本。 |
| ToolTipMaxWidth | 设置或检索与 MSWebDVD 对象关联的工具提示的最大宽度。 |
| GPRM 和 SPRM | |
| GetGPRM | 检索指定的常规参数寄存器。 |
| GetSPRM | 检索指定的系统参数寄存器。 |
| SetGPRM | 将指定的常规参数寄存器设置为指定值。 |
相关主题