Bagikan melalui

Metode IVideoWindow::p ut_FullScreenMode (control.h)

  • Artikel

[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 ini put_FullScreenMode memungkinkan atau menonaktifkan penyajian video layar penuh.

Sintaks

HRESULT put_FullScreenMode(
  [in] long FullScreenMode
);

Parameter

[in] FullScreenMode

Nilai Boolean yang menentukan apakah akan mengaktifkan atau menonaktifkan mode layar penuh. Harus salah satu nilai berikut:

Nilai Deskripsi
OATRUE Beralih ke mode layar penuh.
OAFALSE Nonaktifkan mode layar penuh. (Default.)

Mengembalikan nilai

Nilai yang mungkin dikembalikan meliputi yang berikut ini:

Menampilkan kode Deskripsi
E_NOTIMPL
 Filter tidak mendukung mode layar penuh.
S_FALSE
 Sudah dalam mode yang diminta.
S_OK
 Berhasil.
VFW_E_NO_FULLSCREEN
 Tidak dapat menemukan filter apa pun yang mendukung mode layar penuh.

Keterangan

Bergantung pada perender video, peralihan ke mode layar penuh mungkin tidak terlihat sampai aplikasi berjalan atau menjeda grafik. Dalam mode layar penuh, jika pengguna beralih dari aplikasi (misalnya, menggunakan ALT + TAB), Filter Graph Manager mengirimkan peristiwa EC_FULLSCREEN_LOST .

Keterangan berikut menjelaskan bagaimana Filter Graph Manager menerapkan mode layar penuh. Pengembang aplikasi mungkin dapat mengabaikan informasi ini, tetapi mungkin berguna jika Anda menulis perender video kustom.

Saat aplikasi beralih ke mode layar penuh, Filter Graph Manager mencari perender video yang akan berfungsi paling efisien. Dalam urutan preferensi, ini adalah:

  1. Setiap perender video dalam grafik filter yang secara asli mendukung mode layar penuh.
  2. Setiap perender video dalam grafik filter yang dapat meregangkan video ke layar penuh tanpa biaya performa yang signifikan.
  3. Filter Perender Layar Penuh .
  4. Setiap perender video dalam grafik filter yang mendukung IVideoWindow.
Untuk opsi pertama, Filter Graph Manager memanggil IVideoWindow::get_FullScreenMode pada setiap perender video dalam grafik. Sebagian besar perender mengembalikan E_NOTIMPL, menunjukkan filter tidak secara asli mendukung mode layar penuh. Jika ada perender yang mengembalikan nilai yang tidak sama dengan E_NOTIMPL, Filter Graph Manager akan menggunakannya.

Untuk opsi kedua, Filter Graph Manager memanggil IVideoWindow::GetMaxIdealImageSize dan GetMinIdealImageSize pada setiap perender video dalam grafik. Jika ukuran tampilan berada dalam rentang filter yang dilaporkan, itu menunjukkan bahwa filter dapat meregangkan video tanpa biaya performa yang signifikan.

Catatan Jika grafik dihentikan, Filter Graph Manager menjeda setiap perender sebelum memanggil metode ini. Ini memberi perender kesempatan untuk menginisialisasi sumber daya apa pun yang dibutuhkannya, karena banyak perender tidak dapat menentukan nilai-nilai ini saat dihentikan.
 
Kecuali pada perangkat keras yang lebih lama, opsi kedua umumnya akan berhasil. Opsi ketiga adalah menggunakan filter Penyaji Layar Penuh, menambahkannya ke grafik jika perlu. Opsi keempat hanyalah menemukan perender pertama dalam grafik yang mendukung IVideoWindow, dan meregangkan video terlepas dari performanya.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header control.h (termasuk Dshow.h)
Pustaka Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IVideoWindow

IVideoWindow::get_FullScreenMode