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 |
|---|---|
|
Erfolg. |
|
Ungültiges Argument. |
|
Ungültige Domäne. |
|
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 |
|
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 |