MSWebDVD 对象
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 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® 组件。
MSWebDVD 方法和属性作用于 DVD 导航器的当前状态或光盘上的信息，或同时处理这两者。 若要在注册表中存储和检索各种类型的应用程序特定信息（例如，用户对家长级别和默认语言的首选项），请使用 MSDVDAdm 对象的 方法。 使用 DVDAdm 属性访问此对象。
注意
从 DirectX 9.0b 开始，对象仅在受信任的区域中加载。 它不会加载到不受信任的区域中。
方法和属性（按类别）
| 播放 | |
|---|---|
| CanStep | 确定本地系统上的 MPEG-2 解码器是否可以在指定方向上执行帧步进。 |
| 弹出 | 从驱动器或驱动器中弹出或插入光盘。 |
| FramesPerSecond | 检索当前 DVD 游戏的视频帧速率。 |
| 暂停 | 在当前位置暂停播放。 |
| 玩 | 播放当前 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 | 检索当前游戏中可用的音频流数。 |
| Balance | 设置或检索音频流输出的扬声器平衡。 |
| 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通道中的内容类型。 |
| 卡拉OKeAudioPresentationMode | 设置或检索辅助卡拉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 对象关联的 ToolTip 的延迟时间。 |
| SetDelayTime | 设置与 MSWebDVD 对象关联的工具提示的延迟时间。 |
| ShowCursor | 当 DVD 导航器处于全屏模式时，使鼠标指针可见。 |
| ToolTip | 设置当鼠标指针位于 MSWebDVD 视频矩形上时将显示的工具提示的文本。 |
| ToolTipMaxWidth | 设置或检索与 MSWebDVD 对象关联的工具提示的最大宽度。 |
| GPRM 和 SPRM | |
| GetGPRM | 检索指定的常规参数寄存器。 |
| GetSPRM | 检索指定的系统参数寄存器。 |
| SetGPRM | 将指定的常规参数寄存器设置为指定的值。 |
相关主题