Événements MSWebDVD
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in 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 Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]
Notes
Ce composant peut être utilisé dans les systèmes d’exploitation Microsoft Windows 2000, Windows XP et Windows Server 2003. Il sera peut-être modifié ou indisponible dans les versions ultérieures.
Notes
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 se produisent sur le disque.
La plupart des événements concernent des contrôles d’opération utilisateur (UOP). Les auteurs de DVD peuvent encoder le disque de sorte que n’importe quelle commande DVD (par exemple , PlayForwards, Pause, ShowMenu, etc.) puisse ê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 la lecture de l’avertissement du FBI. 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 indiquer à l’utilisateur 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 Lire. Quand il a reçu cet événement avec bEnabled défini sur TRUE, vous pouvez réactiver le bouton.
Trois événements ne sont pas liés aux contrôles UOP. L’événement DVDNotify informe votre application de nombreux types différents d’événements liés au DVD, qui sont 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 si elles hébergent MSWebDVD en mode sans fenêtre. Les applications doivent répondre à cet événement uniquement si elles 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 | Notifie 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 clé de couleur a changé. |