MSWebDVD Events
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Note
This component is available for use in the Microsoft Windows 2000, Windows XP, and Windows Server 2003 operating systems. It may be altered or unavailable in subsequent versions.
Note
This API is deprecated. For information about DVD playback and navigation in DirectShow, see DVD Applications.
The MSWebDVD Microsoft® ActiveX® control notifies your application when various types of internal events occur or when certain information is encountered on the disc.
Most of the events relate to user operation (UOP) controls. DVD authors can encode the disc so that any DVD command (such as PlayForwards, Pause, ShowMenu, and so on) can be disabled at any time. For example, most discs will not allow users to fast forward or show a menu while the FBI warning is playing. After the warning is over, the disc permits these operations. By handling the UOP events, your application can update its user interface to show the user which commands are currently permitted by the disc. The most common way to do this is by disabling a button. For example, if your application received a PlayForwards event with bEnabled set to FALSE, you could disable the Play button. When it received that event with bEnabled set to TRUE, you could enable the button again.
There are three events that do not relate to UOP controls. The DVDNotify event notifies your application of many different types of DVD-related events, which are identified in the EventCode parameter. Some events have additional information in the Param1 and Param2 parameters. The ReadyStateChange event notifies your application of changes in the MSWebDVD ReadyState property, which is a property common to all ActiveX controls. The UpdateOverlay event is sent to applications only if they are hosting MSWebDVD in windowless mode. Applications need to respond to this event only if they are displaying floating buttons over the video rectangle in full screen mode.
| Event | Description |
|---|---|
| ChangeCurrentAngle | Sent when the disc enables or disables changing the angle. |
| ChangeCurrentAudioStream | Sent when the disc enables or disables changing the audio stream. |
| ChangeCurrentSubpictureStream | Sent when the ChangeCurrentSubpictureStream command has been enabled or disabled. |
| DVDNotify | Notifies an application of many different DVD events and disc instructions. |
| PauseOn | Sent when the Pause command has been enabled or disabled. |
| PlayAtTime | Sent when the PlayAtTime command has been enabled or disabled. |
| PlayAtTimeInTitle | Sent when the PlayAtTimeInTitle command has been enabled or disabled. |
| PlayBackwards | Sent when the PlayBackwards command has been enabled or disabled. |
| PlayChapter | Sent when the PlayChapter command has been enabled or disabled. |
| PlayChapterInTitle | Sent when the PlayChapterInTitle command has been enabled or disabled. |
| PlayForwards | Sent when the PlayForwards command has been enabled or disabled. |
| PlayNextChapter | Sent when the PlayNextChapter command has been enabled or disabled. |
| PlayPrevChapter | Sent when the PlayPrevChapter command has been enabled or disabled. |
| PlayTitle | Sent when the PlayTitle command has been enabled or disabled. |
| ReadyStateChange | Sent when the ReadyState property of the MSWebDVD control has changed. |
| ReplayChapter | Sent when the ReplayChapter command has been enabled or disabled. |
| Resume | Sent when the Resume command has been enabled or disabled. |
| ReturnFromSubmenu | Sent when the ReturnFromSubmenu command has been enabled or disabled. |
| SelectOrActivatButton | Sent when the disc enables or disables the selection or activation of menu buttons. |
| ShowMenu | Sent when the disc enables or disables the showing of a menu. |
| StillOff | Sent when the StillOff command has been enabled or disabled. |
| Stop | Sent when the Stop command has been enabled or disabled. |
| UpdateOverlay | Sent when the overlay surface has been moved or resized or its color key has changed. |
Related topics