Metode CBaseControlVideo.GetVideoPaletteEntries

Artikel
07/28/2023

[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 ini GetVideoPaletteEntries mengambil berbagai entri palet untuk video.

Sintaks

HRESULT GetVideoPaletteEntries(
   long StartIndex,
   long Entries,
   long *pRetrieved,
   long *pPalette
);

Parameter

StartIndex: Entri palet mulai berbasis nol.
Entri: Jumlah entri yang diperlukan.
pRetrieved: Penunjuk ke jumlah warna yang diperoleh.
pPalette: Penunjuk ke buffer output untuk warna.

Mengembalikan nilai

Mengembalikan NOERROR jika berhasil, VFW_E_NO_PALETTE_AVAILABLE jika sampel video tidak memiliki palet warna, E_OUTOFMEMORY jika tidak ada cukup memori yang tersedia, E_INVALIDARG jika StartIndex tidak valid, atau S_FALSE jika tidak ada warna di palet.

Keterangan

Fungsi anggota ini mengembalikan palet video saat ini sebagai array yang dialokasikan oleh pengguna. Agar tetap konsisten, gunakan anggota dalam struktur Win32 PALETTEENTRY untuk mengembalikan warna, bukan anggota dalam struktur RGBQUAD (meskipun parameternya adalah LONG). Memori dialokasikan oleh pemanggil, jadi cukup salin masing-masing secara bergantian. Tentukan bahwa jumlah entri yang diminta dan offset posisi awal keduanya valid. Jika jumlah entri dievaluasi ke nol, kembalikan kode S_FALSE.

Persyaratan

Persyaratan	Nilai
Header	Ctlutil.h (termasuk Streams.h)
Pustaka	Strmbase.lib (build ritel); Strmbasd.lib (build debug)

Lihat juga

Kelas CBaseControlVideo

Share via