Eventos MSWebDVD
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
Nota:
Este componente está disponible para su uso en los sistemas operativos Microsoft Windows 2000, Windows XP y Windows Server 2003. En versiones posteriores podría modificarse o no estar disponible.
Nota:
Esta API está en desuso. Para obtener información sobre la reproducción y navegación de DVD en DirectShow, consulta Aplicaciones de DVD.
El control MSWebDVD Microsoft® ActiveX® notifica a la aplicación cuándo se producen varios tipos de eventos internos o cuando se encuentra cierta información en el disco.
La mayoría de los eventos están relacionados con los controles de operación de usuario (UOP). Los autores de DVD pueden codificar el disco para que cualquier comando de DVD (como PlayForwards, Pause, ShowMenu, etc.) se pueda deshabilitar en cualquier momento. Por ejemplo, la mayoría de los discos no permitirán a los usuarios avanzar rápidamente o mostrar un menú mientras se está reproduciendo la advertencia del FBI. Una vez finalizada la advertencia, el disco permite estas operaciones. Al controlar los eventos UOP, la aplicación puede actualizar su interfaz de usuario para mostrar al usuario los comandos que el disco permite actualmente. La manera más común de hacerlo es deshabilitar un botón. Por ejemplo, si la aplicación recibió un evento PlayForwards con bEnabled establecido en FALSE, podría deshabilitar el botón Reproducir. Cuando recibió ese evento con bEnabled establecido en TRUE, podría volver a habilitar el botón.
Hay tres eventos que no están relacionados con los controles UOP. El evento DVDNotify notifica a la aplicación muchos tipos diferentes de eventos relacionados con DVD, que se identifican en el parámetro EventCode . Algunos eventos tienen información adicional en los parámetros Param1 y Param2 . El evento ReadyStateChange notifica a la aplicación los cambios en la propiedad ReadyState msWebDVD, que es una propiedad común a todos los controles ActiveX. El evento UpdateOverlay solo se envía a las aplicaciones si hospedan MSWebDVD en modo sin ventanas. Las aplicaciones solo deben responder a este evento si muestran botones flotantes sobre el rectángulo de vídeo en modo de pantalla completa.
| Evento | Descripción |
|---|---|
| ChangeCurrentAngle | Se envía cuando el disco habilita o deshabilita el cambio del ángulo. |
| ChangeCurrentAudioStream | Se envía cuando el disco habilita o deshabilita el cambio de la secuencia de audio. |
| ChangeCurrentSubpictureStream | Se envía cuando el comando ChangeCurrentSubpictureStream se ha habilitado o deshabilitado. |
| DVDNotify | Notifica a una aplicación de muchos eventos de DVD y instrucciones de disco diferentes. |
| PauseOn | Se envía cuando el comando Pause se ha habilitado o deshabilitado. |
| PlayAtTime | Se envía cuando el comando PlayAtTime se ha habilitado o deshabilitado. |
| PlayAtTimeInTitle | Se envía cuando el comando PlayAtTimeInTitle se ha habilitado o deshabilitado. |
| PlayBackwards | Se envía cuando el comando PlayBackwards se ha habilitado o deshabilitado. |
| PlayChapter | Se envía cuando el comando PlayChapter se ha habilitado o deshabilitado. |
| PlayChapterInTitle | Se envía cuando el comando PlayChapterInTitle se ha habilitado o deshabilitado. |
| PlayForwards | Se envía cuando el comando PlayForwards se ha habilitado o deshabilitado. |
| PlayNextChapter | Se envía cuando el comando PlayNextChapter se ha habilitado o deshabilitado. |
| PlayPrevChapter | Se envía cuando el comando PlayPrevChapter se ha habilitado o deshabilitado. |
| PlayTitle | Se envía cuando el comando PlayTitle se ha habilitado o deshabilitado. |
| ReadyStateChange | Se envía cuando ha cambiado la propiedad ReadyState del control MSWebDVD. |
| ReplayChapter | Se envía cuando el comando ReplayChapter se ha habilitado o deshabilitado. |
| Reanudar | Se envía cuando el comando Resume se ha habilitado o deshabilitado. |
| ReturnFromSubmenu | Se envía cuando el comando ReturnFromSubmenu se ha habilitado o deshabilitado. |
| SelectOrActivatButton | Se envía cuando el disco habilita o deshabilita la selección o activación de botones de menú. |
| ShowMenu | Se envía cuando el disco habilita o deshabilita la presentación de un menú. |
| StillOff | Se envía cuando el comando StillOff se ha habilitado o deshabilitado. |
| Stop | Se envía cuando el comando Stop se ha habilitado o deshabilitado. |
| UpdateOverlay | Se envía cuando la superficie de superposición se ha movido o cambiado de tamaño o su clave de color ha cambiado. |
Temas relacionados