IDvdControl2::SelectVideoModePreference-Methode (strmif.h)

[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.]

Die SelectVideoModePreference -Methode legt die angegebene Videomodusanzeige (Breitbild, Briefkasten oder Schwenkscan) für die Wiedergabe fest.

Syntax

HRESULT SelectVideoModePreference(
  [in] ULONG ulPreferredDisplayMode
);

Parameter

[in] ulPreferredDisplayMode

Wert, der den neuen Anzeigemodus für DVD-Inhalte angibt. Mitglied der DVD_PREFERRED_DISPLAY_MODE-Enumeration .

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Ungültiges Argument.
VFW_E_DVD_INVALIDDOMAIN	Ungültige Domäne.
VFW_E_DVD_OPERATION_INHIBITED	Die UOP-Steuerung verbietet den Vorgang.

Hinweise

Diese Methode ändert das Seitenverhältnis des Standardvideofensters und kann auch einen Standardmechanismus für die Konvertierung des Seitenverhältnisses angeben.

Für anamorphes 16 x 9-Quellvideo, das durch Dehnung des Quellvideos von 720 x 480 auf ein Seitenverhältnis von 16 x 9 gebildet wird.

Breitbild Das 16 x 9-Quellvideo sollte platziert und in den größten Bereich von 16 x 9 des Clientausgabefensters gestreckt werden. Die Highlights sind relativ zum Inneren des 16 x 9-Bereichs. Schwarze Balken sollten entweder oben/unten oder an den Seiten hinzugefügt werden, um einen Bereich von 16 x 9 zu erhalten.

Schwenkscan Das gezeigte Video wird berechnet, indem ein 4 x 3-Unterfenster aus dem gestreckten 16 x 9-Video verwendet wird (der horizontale Offset wird im Offset des MPEG-2-Videos bereitgestellt). Der Unterfenster 4 x 3 befindet sich im größten Bereich des Ausgabeclientfensters mit 4 x 3. Die Koordinaten der Hervorhebung sind relativ zum Ausgabefenster 4 x 3 (und haben keine Beziehung zum Quellvideo 16 x 9). Schwarze Balken sollten entweder oben/unten oder an den Seiten hinzugefügt werden, um einen Bereich von 4 x 3 beizubehalten.

Briefkasten Ein Anzeigebereich von 4 x 3 wird gebildet, indem der größte Bereich des Ausgabeclientfensters mit 4 x 3 verwendet wird. Schwarze Balken sollten entweder oben/unten oder an den Seiten hinzugefügt werden, um einen Bereich von 4 x 3 beizubehalten. Das Quellvideo 16 x 9 befindet sich im größten 16 x 9-Unterwindow innerhalb des 4 x 3-Unterfensters. Schwarze Balken sollten oben und unten im Unterfenster hinzugefügt werden, um einen Bereich von 16 x 9 beizubehalten. Die Koordinaten des Hervorhebungszeichens sind relativ zum Unterfenster 4 x 3 (und haben keine Beziehung zum Quellvideo 16 x 9). Es ist technisch möglich, dass ein Datenträger ein Highlight vorgibt, das außerhalb des Bereichs 16 x 9 liegt (aber immer noch im Fenster 4 x 3).

Bei 4 x 3 Videos wird das Video im größten Ausgabebereich von 4 x 3 des Ausgabeclientfensters platziert. Schwarze Balken sollten entweder oben/unten oder an den Seiten hinzugefügt werden, um einen Bereich von 4 x 3 beizubehalten.

Die folgende Tabelle zeigt den Anhang J-Befehlsnamen, dem dieser Methodenname entspricht, und die Domänen, in denen diese Methode gültig ist.

Anhang J Befehlsname	Gültige Domänen
Video_Presentation_Mode_Change	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdControl2-Schnittstelle