MSWebDVD-Ereignisse
Hinweis
Diese Komponente ist für die Verwendung in den Betriebssystemen Microsoft Windows 2000, Windows XP und Windows Server 2003 verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden.
Hinweis
Diese API ist veraltet. Informationen zur DVD-Wiedergabe und -Navigation in DirectShow finden Sie unter DVD-Anwendungen.
Das Microsoft® ActiveX®-Steuerelement MSWebDVD benachrichtigt Ihre Anwendung, wenn verschiedene Typen interner Ereignisse auftreten oder bestimmte Informationen auf dem Datenträger gefunden werden.
Die meisten Ereignisse beziehen sich auf UOP-Steuerelemente (User Operation). DVD-Autoren können den Datenträger codieren, sodass jeder DVD-Befehl (z. B. PlayForwards, Pause, ShowMenu usw.) jederzeit deaktiviert werden kann. Auf den meisten Datenträgern können Benutzer z. B. während der Wiedergabe der FBI-Warnung keine schnelle Weiterleitung oder Einblendung eines Menüs zulassen. Nachdem die Warnung beendet wurde, lässt der Datenträger diese Vorgänge zu. Durch die Behandlung der UOP-Ereignisse kann Ihre Anwendung ihre Benutzeroberfläche aktualisieren, um dem Benutzer anzuzeigen, welche Befehle derzeit vom Datenträger zugelassen werden. Die gängigste Methode hierfür ist das Deaktivieren einer Schaltfläche. Wenn Ihre Anwendung beispielsweise ein PlayForwards-Ereignis empfangen hat, bei dem bEnabled auf FALSE festgelegt ist, können Sie die Wiedergabeschaltfläche deaktivieren. Wenn das Ereignis empfangen wurde und bEnabled auf TRUE festgelegt ist, können Sie die Schaltfläche erneut aktivieren.
Es gibt drei Ereignisse, die sich nicht auf UOP-Steuerelemente beziehen. Das DVDNotify-Ereignis benachrichtigt Ihre Anwendung über viele verschiedene Typen von DVD-bezogenen Ereignissen, die im EventCode-Parameter identifiziert werden. Einige Ereignisse enthalten zusätzliche Informationen in den Parametern Param1 und Param2. Das ReadyStateChange-Ereignis benachrichtigt Ihre Anwendung über Änderungen an der ReadyState-Eigenschaft MSWebDVD, bei der es sich um eine Eigenschaft handelt, die allen ActiveX-Steuerelementen gemeinsam ist. Das UpdateOverlay-Ereignis wird nur an Anwendungen gesendet, wenn sie MSWebDVD im fensterlosen Modus hosten. Anwendungen müssen nur dann auf dieses Ereignis reagieren, wenn sie unverankerte Schaltflächen über dem Videorechteck im Vollbildmodus anzeigen.
| Ereignis | BESCHREIBUNG |
|---|---|
| ChangeCurrentAngle | Wird gesendet, wenn der Datenträger das Ändern des Winkels aktiviert oder deaktiviert. |
| ChangeCurrentAudioStream | Wird gesendet, wenn der Datenträger das Ändern des Audiodatenstroms aktiviert oder deaktiviert. |
| ChangeCurrentSubpictureStream | Wird gesendet, wenn der ChangeCurrentSubpictureStream-Befehl aktiviert oder deaktiviert wurde. |
| DVDNotify | Benachrichtigt eine Anwendung über viele verschiedene DVD-Ereignisse und Datenträgeranweisungen. |
| PauseOn | Wird gesendet, wenn der Befehl Anhalten aktiviert oder deaktiviert wurde. |
| PlayAtTime | Wird gesendet, wenn der PlayAtTime-Befehl aktiviert oder deaktiviert wurde. |
| PlayAtTimeInTitle | Wird gesendet, wenn der PlayAtTimeInTitle-Befehl aktiviert oder deaktiviert wurde. |
| PlayBackwards | Wird gesendet, wenn der PlayBackwards-Befehl aktiviert oder deaktiviert wurde. |
| PlayChapter | Wird gesendet, wenn der PlayChapter-Befehl aktiviert oder deaktiviert wurde. |
| PlayChapterInTitle | Wird gesendet, wenn der PlayChapterInTitle-Befehl aktiviert oder deaktiviert wurde. |
| PlayForwards | Wird gesendet, wenn der PlayForwards-Befehl aktiviert oder deaktiviert wurde. |
| PlayNextChapter | Wird gesendet, wenn der PlayNextChapter-Befehl aktiviert oder deaktiviert wurde. |
| PlayPrevChapter | Wird gesendet, wenn der PlayPrevChapter-Befehl aktiviert oder deaktiviert wurde. |
| PlayTitle | Wird gesendet, wenn der PlayTitle-Befehl aktiviert oder deaktiviert wurde. |
| ReadyStateChange | Wird gesendet, wenn sich die ReadyState-Eigenschaft des MSWebDVD-Steuerelements geändert hat. |
| ReplayChapter | Wird gesendet, wenn der ReplayChapter-Befehl aktiviert oder deaktiviert wurde. |
| Fortsetzen | Wird gesendet, wenn der Befehl Fortsetzen aktiviert oder deaktiviert wurde. |
| ReturnFromSubmenu | Wird gesendet, wenn der Befehl ReturnFromSubmenu aktiviert oder deaktiviert wurde. |
| SelectOrActivatButton | Wird gesendet, wenn der Datenträger die Auswahl oder Aktivierung von Menüschaltflächen aktiviert oder deaktiviert. |
| ShowMenu | Wird gesendet, wenn der Datenträger die Anzeige eines Menüs aktiviert oder deaktiviert. |
| StillOff | Wird gesendet, wenn der StillOff-Befehl aktiviert oder deaktiviert wurde. |
| Beenden | Wird gesendet, wenn der Befehl Beenden aktiviert oder deaktiviert wurde. |
| UpdateOverlay | Wird gesendet, wenn die Überlagerungsoberfläche verschoben oder geändert wurde oder der Farbschlüssel geändert wurde. |