События 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, Приостановка, ShowMenuи т. д.) может быть отключена в любое время. Например, большинство дисков не позволит пользователям быстро переадресовать или отобразить меню во время воспроизведения предупреждения ФБР. После завершения предупреждения диск разрешает эти операции. Обрабатывая события UOP, приложение может обновить пользовательский интерфейс, чтобы показать пользователю, какие команды в настоящее время разрешены диском. Наиболее распространенным способом этого является отключение кнопки. Например, если приложение получило событие PlayForwards с bEnabled значением FALSE, можно отключить кнопку воспроизведения. После получения этого события с bEnabled задано значение TRUE, можно снова включить кнопку.
Существует три события, которые не связаны с элементами управления UOP. Событие DVDNotify уведомляет приложение о различных типах событий, связанных с DVD, которые определены в параметре EventCode. Некоторые события содержат дополнительные сведения в параметрах Param1 и Param2. Событие ReadyStateChange уведомляет приложение об изменениях в свойстве MSWebDVD ReadyState, которое является свойством, общим для всех элементов 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 включена или отключена. |
| возобновление | Отправляется, когда команда Резюме включена или отключена. |
| ReturnFromSubmenu | Отправляется, когда команда returnFromSubmenu включена или отключена. |
| SelectOrActivatButton | Отправляется, когда диск включает или отключает выделение или активацию кнопок меню. |
| ShowMenu | Отправляется, когда диск включает или отключает отображение меню. |
| StillOff | Отправляется при включении или отключении команды StillOff. |
| остановить | Отправляется при включении или отключении команды остановки . |
| UpdateOverlay | Отправляется при перемещении или изменении размера поверхности наложения или изменении его цветового ключа. |
Связанные разделы