MSWebDVD-Ereignisse

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

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 von internen Ereignissen auftreten oder wenn bestimmte Informationen auf dem Datenträger gefunden werden.

Die meisten Ereignisse beziehen sich auf Benutzerbetriebssteuerelemente (User Operation, UOP). DVD-Autoren können den Datenträger codieren, sodass alle DVD-Befehle (z. B . PlayForwards, Pause, ShowMenu usw.) jederzeit deaktiviert werden können. Bei den meisten Datenträgern können Benutzer beispielsweise kein Vor- oder Anzeigemenü anzeigen, während die FBI-Warnung wiedergegeben wird. Nachdem die Warnung abgelaufen ist, 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 auf dem Datenträger zulässig sind. Die gängigste Möglichkeit hierfür ist das Deaktivieren einer Schaltfläche. Wenn Ihre Anwendung beispielsweise ein PlayForwards-Ereignis erhalten hat, bei dem bEnabled auf FALSE festgelegt ist, können Sie die Wiedergabeschaltfläche deaktivieren. Wenn dieses 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 Arten 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 in der MSWebDVD-ReadyState-Eigenschaft, einer Eigenschaft, die allen ActiveX-Steuerelementen gemeinsam ist. Das UpdateOverlay-Ereignis wird nur dann an Anwendungen gesendet, wenn sie MSWebDVD im fensterlosen Modus hosten. Anwendungen müssen nur auf dieses Ereignis reagieren, wenn sie im Vollbildmodus schwebende Schaltflächen über dem Videorechteck anzeigen.

event	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 Befehl ChangeCurrentSubpictureStream aktiviert oder deaktiviert wurde.
DVDNotify	Benachrichtigt eine Anwendung von vielen verschiedenen DVD-Ereignissen und Disc-Anweisungen.
PauseOn	Wird gesendet, wenn der Befehl Pause 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 Befehl PlayChapterInTitle 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.
WiedergabeChapter	Wird gesendet, wenn der Befehl ReplayChapter 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 Überlagerungsfläche verschoben oder die Größe geändert wurde oder die Farbtaste geändert wurde.

 

Zugehörige Themen

MSWebDVD-Objekt