Eventos MSWebDVD
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
Observação
Este componente está disponível para utilização nos sistemas operativos Microsoft Windows 2000, Windows XP e Windows Server 2003. Pode ser alterado ou não estar disponível em versões subsequentes.
Observação
Esta API foi preterida. Para obter informações sobre reprodução e navegação de DVD no DirectShow, consulte Aplicativos de DVD.
O controle Microsoft® ActiveX® MSWebDVD notifica seu aplicativo quando vários tipos de eventos internos ocorrem ou quando determinadas informações são encontradas no disco.
A maioria dos eventos está relacionada a controles de operação do usuário (UOP). Os autores de DVD podem codificar o disco para que qualquer comando de DVD (como PlayForwards, Pause, ShowMenue assim por diante) possa ser desativado a qualquer momento. Por exemplo, a maioria dos discos não permitirá que os usuários avancem rapidamente ou mostrem um menu enquanto o aviso do FBI estiver sendo reproduzido. Depois que o aviso termina, o disco permite essas operações. Ao manipular os eventos UOP, seu aplicativo pode atualizar sua interface do usuário para mostrar ao usuário quais comandos são atualmente permitidos pelo disco. A maneira mais comum de fazer isso é desativando um botão. Por exemplo, se o seu aplicativo recebeu um evento PlayForwards com bEnabled definido como FALSE, você pode desativar o botão Play. Quando ele recebeu esse evento com bEnabled definido como TRUE, você pode ativar o botão novamente.
Há três eventos que não estão relacionados aos controles UOP. O evento DVDNotify notifica seu aplicativo de muitos tipos diferentes de eventos relacionados a DVD, que são identificados no parâmetro EventCode. Alguns eventos têm informações adicionais nos parâmetros Param1 e Param2. O evento ReadyStateChange notifica seu aplicativo sobre alterações na propriedade MSWebDVD ReadyState, que é uma propriedade comum a todos os controles ActiveX. O evento UpdateOverlay é enviado para aplicativos somente se eles estiverem hospedando MSWebDVD no modo sem janelas. Os aplicativos precisam responder a esse evento somente se estiverem exibindo botões flutuantes sobre o retângulo de vídeo no modo de tela cheia.
| Evento | Descrição |
|---|---|
| ChangeCurrentAngle | Enviado quando o disco ativa ou desativa a alteração do ângulo. |
| ChangeCurrentAudioStream | Enviado quando o disco ativa ou desativa a alteração do fluxo de áudio. |
| ChangeCurrentSubpictureStream | Enviado quando o comando ChangeCurrentSubpictureStream tiver sido ativado ou desativado. |
| DVDNotify | Notifica um aplicativo de muitos eventos de DVD diferentes e instruções de disco. |
| PauseOn | Enviado quando o comando Pausar tiver sido ativado ou desativado. |
| PlayAtTime | Enviado quando o comando PlayAtTime tiver sido ativado ou desativado. |
| PlayAtTimeInTitle | Enviado quando o comando PlayAtTimeInTitle tiver sido ativado ou desativado. |
| PlayBackwards | Enviado quando o comando PlayBackwards tiver sido ativado ou desativado. |
| PlayCapítulo | Enviado quando o comando PlayChapter tiver sido ativado ou desativado. |
| PlayChapterInTitle | Enviado quando o comando PlayChapterInTitle tiver sido ativado ou desativado. |
| PlayForwards | Enviado quando o comando PlayForwards tiver sido ativado ou desativado. |
| PlayNextCapítulo | Enviado quando o comando PlayNextChapter tiver sido ativado ou desativado. |
| PlayPrevCapítulo | Enviado quando o comando PlayPrevChapter tiver sido ativado ou desativado. |
| PlayTitle | Enviado quando o comando PlayTitle tiver sido ativado ou desativado. |
| ReadyStateChange | Enviado quando a propriedade ReadyState do controle MSWebDVD foi alterada. |
| ReplayCapítulo | Enviado quando o comando ReplayChapter tiver sido ativado ou desativado. |
| Currículo | Enviado quando o comando Resume tiver sido ativado ou desativado. |
| ReturnFromSubmenu | Enviado quando o comando ReturnFromSubmenu tiver sido ativado ou desativado. |
| SelectOrActivatButton | Enviado quando o disco ativa ou desativa a seleção ou ativação de botões de menu. |
| ShowMenu | Enviado quando o disco ativa ou desativa a exibição de um menu. |
| StillOff | Enviado quando o comando StillOff tiver sido ativado ou desativado. |
| Pare | Enviado quando o comando Stop tiver sido ativado ou desativado. |
| UpdateOverlay | Enviado quando a superfície de sobreposição foi movida ou redimensionada ou sua chave de cor foi alterada. |
Tópicos relacionados