Metode IVideoWindow::p ut_BackgroundPalette (control.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 menentukan put_BackgroundPalette apakah jendela video mewujudkan paletnya di latar belakang.

Sintaks

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

Parameter

[in] BackgroundPalette

Menentukan apakah perender video menyadari palet di latar belakang. Harus salah satu nilai berikut:

Nilai	Deskripsi
OATRUE	Perender video menyadari palet di latar belakang.
OAFALSE	Perender video tidak menyadari palet di latar belakang. (Default.)

Nilai kembali

Nilai yang mungkin dikembalikan meliputi yang berikut ini:

Menampilkan kode	Deskripsi
E_INVALIDARG	Argumen tidak valid.
S_OK	Berhasil.
VFW_E_NOT_CONNECTED	Filter perender video tidak tersambung.

Keterangan

Jika BackgroundPalette adalah OATRUE dan gambar video memerlukan palet, perender video akan menyadari palet itu di latar belakang. Warna apa pun yang digunakan palet akan berubah ke kecocokan terdekatnya di palet tampilan sebelum menggambar. Ini memastikan bahwa aplikasi tidak akan terganggu paletnya. Namun, itu memberlakukan penalti performa yang parah pada video.

Persyaratan

Persyaratan	Nilai
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_BackgroundPalette