Partager via


Événements MSWebDVD

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngineet audio/vidéo capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et capture audio/vidéo dans Media Foundation au lieu de directShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Note

Ce composant est disponible pour une utilisation dans les systèmes d’exploitation Microsoft Windows 2000, Windows XP et Windows Server 2003. Il peut être modifié ou indisponible dans les versions ultérieures.

 

Note

Cette API est déconseillée. Pour plus d’informations sur la lecture et la navigation de DVD dans DirectShow, consultez applications DVD.

 

Le contrôle Microsoft® ActiveX® MSWebDVD avertit votre application lorsque différents types d’événements internes se produisent ou lorsque certaines informations sont rencontrées sur le disque.

La plupart des événements concernent les contrôles d’opération utilisateur (UOP). Les auteurs de DVD peuvent encoder le disque afin que n’importe quelle commande DVD (par exemple, PlayForwards, Pause, ShowMenu, etc.) peut être désactivée à tout moment. Par exemple, la plupart des disques ne permettent pas aux utilisateurs d’avancer rapidement ou d’afficher un menu pendant que l’avertissement du FBI est en cours de lecture. Une fois l’avertissement terminé, le disque autorise ces opérations. En gérant les événements UOP, votre application peut mettre à jour son interface utilisateur pour afficher les commandes actuellement autorisées par le disque. La méthode la plus courante consiste à désactiver un bouton. Par exemple, si votre application a reçu un événement PlayForwards avec bEnabled défini sur FALSE, vous pouvez désactiver le bouton Lecture. Lorsqu’il a reçu cet événement avec bEnabled défini sur TRUE, vous pouvez réactiver le bouton.

Il existe trois événements qui ne sont pas liés aux contrôles UOP. L’événement DVDNotify avertit votre application de nombreux types d’événements liés au DVD, identifiés dans le paramètre EventCode. Certains événements ont des informations supplémentaires dans les paramètres param1 et Param2. L’événement ReadyStateChange informe votre application des modifications apportées à la propriété MSWebDVD ReadyState, qui est une propriété commune à tous les contrôles ActiveX. L’événement UpdateOverlay est envoyé aux applications uniquement s’ils hébergent MSWebDVD en mode sans fenêtre. Les applications doivent répondre à cet événement uniquement s’ils affichent des boutons flottants sur le rectangle vidéo en mode plein écran.

Événement Description
ChangeCurrentAngle Envoyé lorsque le disque active ou désactive la modification de l’angle.
ChangeCurrentAudioStream Envoyé lorsque le disque active ou désactive la modification du flux audio.
ChangeCurrentSubpictureStream Envoyé lorsque la commande ChangeCurrentSubpictureStream a été activée ou désactivée.
DVDNotify Avertit une application de nombreux événements DVD et instructions de disque différents.
PauseOn Envoyé lorsque la commande Pause a été activée ou désactivée.
PlayAtTime Envoyé lorsque la commande PlayAtTime a été activée ou désactivée.
PlayAtTimeInTitle Envoyé lorsque la commande PlayAtTimeInTitle a été activée ou désactivée.
PlayBackwards Envoyé lorsque la commande PlayBackwards a été activée ou désactivée.
PlayChapter Envoyé lorsque la commande PlayChapter a été activée ou désactivée.
PlayChapterInTitle Envoyé lorsque la commande PlayChapterInTitle a été activée ou désactivée.
PlayForwards Envoyé lorsque la commande PlayForwards a été activée ou désactivée.
PlayNextChapter Envoyé lorsque la commande PlayNextChapter a été activée ou désactivée.
PlayPrevChapter Envoyé lorsque la commande PlayPrevChapter a été activée ou désactivée.
PlayTitle Envoyé lorsque la commande PlayTitle a été activée ou désactivée.
ReadyStateChange Envoyé lorsque la propriété ReadyState du contrôle MSWebDVD a changé.
ReplayChapter Envoyé lorsque la commande ReplayChapter a été activée ou désactivée.
Reprendre Envoyé lorsque la commande Reprendre a été activée ou désactivée.
ReturnFromSubmenu Envoyé lorsque la commande ReturnFromSubmenu a été activée ou désactivée.
SelectOrActivatButton Envoyé lorsque le disque active ou désactive la sélection ou l’activation des boutons de menu.
showMenu Envoyé lorsque le disque active ou désactive l’affichage d’un menu.
StillOff Envoyé lorsque la commande StillOff a été activée ou désactivée.
Arrêter Envoyé lorsque la commande Arrêter a été activée ou désactivée.
UpdateOverlay Envoyé lorsque la surface de superposition a été déplacée ou redimensionnée ou que sa touche de couleur a changé.

 

objet MSWebDVD