Metode IOverlay::SetPalette (strmif.h)

  • Artikel

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 SetPalette ini mengatur palet.

Sintaks

HRESULT SetPalette(
  [in] DWORD        dwColors,
  [in] PALETTEENTRY *pPalette
);

Parameter

[in] dwColors

Jumlah warna yang ada.

[in] pPalette

Arahkan ke warna yang akan digunakan untuk palet.

Mengembalikan nilai

Mengembalikan S_OK jika berhasil. Jika metode gagal, metode mengembalikan kode kesalahan HRESULT .

Keterangan

Metode ini mengatur palet logis untuk jendela. Jendela tidak dijamin untuk selalu memiliki warna yang diminta di palet perangkat sistem yang sebenarnya. Sistem operasi Microsoft® Windows® hanya menjamin warna-warna tersebut ketika jendela adalah jendela aktif latar depan. Palet perangkat saat ini dapat diperoleh dengan memanggil IOverlay::GetPalette.

Jika perangkat tidak memiliki palet, perangkat akan mengembalikan VFW_E_NO_DISPLAY_PALETTE.

Filter Overlay Mixer mengembalikan E_NOTIMPL.

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 strmif.h (termasuk Dshow.h)
Pustaka Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IOverlay