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	将指定的常规参数寄存器设置为指定的值。

 

相关主题

MSWebDVD ActiveX 控件