MSWebDVD Events
| Microsoft DirectShow 9.0 |
MSWebDVD Events
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.
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 he 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.
See Also
| 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. |