IDvdControl2::SelectVideoModePreference method (strmif.h)

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode SelectVideoModePreference ini mengatur tampilan mode video yang ditentukan (layar lebar, kotak surat, atau pan-scan) untuk pemutaran.

Sintaks

HRESULT SelectVideoModePreference(
  [in] ULONG ulPreferredDisplayMode
);

Parameter

[in] ulPreferredDisplayMode

Nilai yang menentukan mode tampilan baru untuk konten DVD. Anggota enumerasi DVD_PREFERRED_DISPLAY_MODE .

Mengembalikan nilai

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	Argumen tidak valid.
VFW_E_DVD_INVALIDDOMAIN	Domain tidak valid.
VFW_E_DVD_OPERATION_INHIBITED	Kontrol UOP melarang operasi.

Keterangan

Metode ini mengubah rasio aspek jendela video default dan juga dapat menentukan mekanisme konversi rasio aspek default.

Untuk video sumber anamorphic 16 x 9, dibentuk dengan meregangkan video sumber 720 x 480 ke rasio aspek 16 x 9.

Layar lebar Video sumber 16 x 9 harus ditempatkan dan direntangkan ke area 16 x 9 terbesar dari jendela output klien. Sorotan relatif terhadap bagian dalam area 16 x 9. Bilah hitam harus ditambahkan ke atas/bawah atau ke samping untuk mempertahankan area 16 x 9.

Pindai Geser Video yang ditampilkan dihitung dengan mengambil subwindow 4 x 3 dari video 16 x 9 yang direntangkan (offset horizontal disediakan dalam offset jendela video MPEG-2). Subwindow 4 x 3 ditempatkan ke area 4 x 3 terbesar dari jendela klien output. Koordinat sorotan relatif terhadap jendela output 4 x 3 (dan tidak memiliki hubungan dengan video sumber 16 x 9). Bilah hitam harus ditambahkan ke atas/bawah atau ke samping untuk mempertahankan area 4 x 3.

Letterbox Area tampilan 4 x 3 dibentuk dengan mengambil area 4 x 3 terbesar dari jendela klien output. Bilah hitam harus ditambahkan ke atas/bawah atau ke samping untuk mempertahankan area 4 x 3. Video sumber 16 x 9 ditempatkan di subwindow 16 x 9 terbesar di dalam subwindow 4 x 3. Bilah hitam harus ditambahkan ke bagian atas dan bawah subwindow untuk mempertahankan area 16 x 9. Koordinat sorotan relatif terhadap subwindow 4 x 3 (dan tidak memiliki hubungan dengan video sumber 16 x 9). Secara teknis dimungkinkan bagi disk untuk menentukan sorotan yang terletak di luar area 16 x 9 (tetapi masih di jendela 4 x 3).

Untuk video 4 x 3, video ditempatkan di area output 4 x 3 terbesar dari jendela klien output. Bilah hitam harus ditambahkan ke atas/bawah atau ke samping untuk mempertahankan area 4 x 3.

Tabel berikut ini memperlihatkan nama perintah Annex J yang sesuai dengan nama metode ini, dan domain di mana metode ini valid.

Nama Perintah Annex J	Domain yang Valid
Video_Presentation_Mode_Change	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Aplikasi DVD

Kode Kesalahan dan Keberhasilan

Antarmuka IDvdControl2