Eventos MSWebDVD
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use 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
Esse componente está disponível para uso nos sistemas operacionais Microsoft Windows 2000, Windows XP e Windows Server 2003. Ele poderá ser alterado ou ficar indisponível em versões subsequentes.
Observação
Essa API está preterida. Para obter informações sobre reprodução e navegação de DVD no DirectShow, consulte Aplicativos de DVD.
O controle MsWebDVD Microsoft® ActiveX® 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 aos controles de UOP (operação do usuário). Os autores de DVD podem codificar o disco para que qualquer comando de DVD (como PlayForwards, Pause, ShowMenu e assim por diante) possa ser desabilitado a qualquer momento. Por exemplo, a maioria dos discos não permitirá que os usuários avancem ou mostrem um menu enquanto o aviso do FBI estiver sendo reproduzido. Depois que o aviso terminar, o disco permitirá essas operações. Ao lidar com os eventos UOP, seu aplicativo pode atualizar sua interface do usuário para mostrar ao usuário quais comandos são permitidos atualmente pelo disco. A maneira mais comum de fazer isso é desabilitando um botão. Por exemplo, se o aplicativo recebeu um evento PlayForwards com bEnabled definido como FALSE, você poderá desabilitar o botão Reproduzir. Quando ele recebeu esse evento com bEnabled definido como TRUE, você poderá habilitar o botão novamente.
Há três eventos que não estão relacionados a 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 sua aplicação de alterações na propriedade ReadyState MSWebDVD, que é uma propriedade comum a todos os controles ActiveX. O evento UpdateOverlay será enviado para aplicativos somente se eles estiverem hospedando MSWebDVD no modo sem janelas. Os aplicativos só precisarão responder a esse evento se estiverem exibindo botões flutuantes sobre o retângulo de vídeo no modo de tela inteira.
| Evento | Descrição |
|---|---|
| ChangeCurrentAngle | Enviado quando o disco habilita ou desabilita a alteração do ângulo. |
| ChangeCurrentAudioStream | Enviado quando o disco habilita ou desabilita a alteração do fluxo de áudio. |
| ChangeCurrentSubpictureStream | Enviado quando o comando ChangeCurrentSubpictureStream foi habilitado ou desabilitado. |
| DVDNotify | Notifica um aplicativo de muitos eventos de DVD diferentes e instruções de disco. |
| PauseOn | Enviado quando o comando Pausar foi habilitado ou desabilitado. |
| PlayAtTime | Enviado quando o comando PlayAtTime foi habilitado ou desabilitado. |
| PlayAtTimeInTitle | Enviado quando o comando PlayAtTimeInTitle foi habilitado ou desabilitado. |
| PlayBackwards | Enviado quando o comando PlayBackwards foi habilitado ou desabilitado. |
| PlayChapter | Enviado quando o comando PlayChapter foi habilitado ou desabilitado. |
| PlayChapterInTitle | Enviado quando o comando PlayChapterInTitle foi habilitado ou desabilitado. |
| PlayForwards | Enviado quando o comando PlayForwards foi habilitado ou desabilitado. |
| PlayNextChapter | Enviado quando o comando PlayNextChapter foi habilitado ou desabilitado. |
| PlayPrevChapter | Enviado quando o comando PlayPrevChapter foi habilitado ou desabilitado. |
| PlayTitle | Enviado quando o comando PlayTitle foi habilitado ou desabilitado. |
| ReadyStateChange | Enviado quando a propriedade ReadyState do controle MSWebDVD foi alterada. |
| ReplayChapter | Enviado quando o comando ReplayChapter foi habilitado ou desabilitado. |
| Retomar | Enviado quando o comando Retomar foi habilitado ou desabilitado. |
| ReturnFromSubmenu | Enviado quando o comando ReturnFromSubmenu foi habilitado ou desabilitado. |
| SelectOrActivatButton | Enviado quando o disco habilita ou desabilita a seleção ou a ativação dos botões de menu. |
| ShowMenu | Enviado quando o disco habilita ou desabilita a exibição de um menu. |
| StillOff | Enviado quando o comando StillOff foi habilitado ou desabilitado. |
| Parar | Enviado quando o comando Parar foi habilitado ou desabilitado. |
| Updateoverlay | Enviado quando a superfície de sobreposição foi movida ou redimensionada ou sua chave de cor foi alterada. |
Tópicos relacionados