É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é. |
Rubriques connexes