События MSWebDVD
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Примечание
Этот компонент доступен для использования в операционных системах Microsoft Windows 2000, Windows XP и Windows Server 2003. В последующих версиях он может быть изменен или недоступен.
Примечание
Это нерекомендуемый API. Сведения о воспроизведении DVD и навигации в DirectShow см. в разделе Приложения DVD.
Элемент управления Microsoft® ActiveX® MSWebDVD уведомляет приложение при возникновении различных типов внутренних событий или при обнаружении определенных сведений на диске.
Большинство событий связаны с элементами управления пользовательской операцией (UOP). Авторы DVD-дисков могут закодировать диск таким образом, чтобы любые команды DVD (например , PlayForwards, Pause, ShowMenu и т. д.) можно было в любое время отключить. Например, большинство дисков не позволяют пользователям перемежаться вперед или показывать меню во время воспроизведения предупреждения ФБР. После завершения предупреждения диск разрешает эти операции. Обрабатывая события UOP, приложение может обновить пользовательский интерфейс, чтобы показать пользователю, какие команды в настоящее время разрешены диском. Наиболее распространенный способ сделать это — отключить кнопку. Например, если приложение получило событие PlayForwards с параметром bEnabled , для параметра значение FALSE, можно отключить кнопку Воспроизвести. Получив это событие с параметром bEnabled , для него задано значение TRUE, можно снова включить кнопку.
Существует три события, которые не связаны с элементами управления UOP. Событие DVDNotify уведомляет приложение о множестве различных типов событий, связанных с DVD, которые определены в параметре EventCode . Некоторые события содержат дополнительные сведения в параметрах Param1 и Param2 . Событие ReadyStateChange уведомляет приложение об изменениях в свойстве READYState MSWebDVD, которое является общим для всех элементов ActiveX. Событие UpdateOverlay отправляется в приложения, только если они размещают MSWebDVD в режиме без окон. Приложения должны реагировать на это событие, только если они отображают плавающие кнопки над прямоугольником видео в полноэкранном режиме.
| Событие | Описание |
|---|---|
| ChangeCurrentAngle | Отправляется, когда диск включает или отключает изменение угла. |
| ChangeCurrentAudioStream | Отправляется, когда диск включает или отключает изменение звукового потока. |
| ChangeCurrentSubpictureStream | Отправляется, когда команда ChangeCurrentSubpictureStream включена или отключена. |
| DVDNotify | Уведомляет приложение о множестве различных событий DVD и инструкций по дискам. |
| PauseOn | Отправляется, когда команда Пауза включена или отключена. |
| PlayAtTime | Отправляется, когда команда PlayAtTime включена или отключена. |
| PlayAtTimeInTitle | Отправляется, когда команда PlayAtTimeInTitle включена или отключена. |
| PlayBackwards | Отправляется, если команда PlayBackwards включена или отключена. |
| PlayChapter | Отправляется, когда команда PlayChapter включена или отключена. |
| PlayChapterInTitle | Отправляется, когда команда PlayChapterInTitle включена или отключена. |
| PlayForwards | Отправляется, когда команда PlayForwards включена или отключена. |
| PlayNextChapter | Отправляется, если команда PlayNextChapter включена или отключена. |
| PlayPrevChapter | Отправляется, когда команда PlayPrevChapter включена или отключена. |
| PlayTitle | Отправляется, когда команда PlayTitle включена или отключена. |
| ReadyStateChange | Отправляется при изменении свойства ReadyState элемента управления MSWebDVD. |
| ReplayChapter | Отправляется, когда команда ReplayChapter включена или отключена. |
| Возобновить | Отправляется, если команда Resume была включена или отключена. |
| ReturnFromSubmenu | Отправляется, когда команда ReturnFromSubmenu включена или отключена. |
| SelectOrActivatButton | Отправляется, когда диск включает или отключает выбор или активацию кнопок меню. |
| ShowMenu | Отправляется, когда диск включает или отключает отображение меню. |
| StillOff | Отправляется, если команда StillOff включена или отключена. |
| Остановить | Отправляется, когда команда Stop была включена или отключена. |
| UpdateOverlay | Отправляется при перемещении или изменении размера поверхности наложения или изменении цветового ключа. |
Связанные темы