Antarmuka IOverlayNotify (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.]

Antarmuka IOverlayNotify menyediakan filter upstram, seperti dekoder, dengan pemberitahuan perubahan pada jendela penyajian. Ini termasuk pemberitahuan perubahan pada palet, kunci warna, dan posisi jendela, dan perubahan wilayah (kliping) yang terlihat.

Sebagian besar dekode video perangkat lunak memungkinkan perender video menggambar gambar yang didekompresi yang mereka hasilkan dengan meneruskan sampel media ke antarmuka IMemInputPin pada pin input perender.

Namun, beberapa filter pendekodean video (biasanya papan dekompresi perangkat keras) menangani gambar gambar itu sendiri, mungkin dengan menggunakan konektor VGA. Filter ini tidak perlu menggunakan IMemInputPin, tetapi dapat menggunakan antarmuka IOverlay yang disediakan oleh pin input perender. Melalui antarmuka ini, dekoder dapat diberi tahu ketika posisi atau ukuran jendela berubah, atau ketika palet sistem saat ini berubah untuk menginstal dan mengubah kunci warna dan palet.

Decoder yang melakukan gambar mereka sendiri harus mengimplementasikan IOverlayNotify antarmuka dan IOverlayNotify2 . Perender menggunakan antarmuka ini untuk memberi tahu dekoder setiap kali ukuran jendela atau posisi berubah, palet sistem berubah, atau kunci warna yang berbeda digunakan. Decoder harus memanggil metode IOverlay::Advise pada pin input perender, untuk menyiapkan panggilan balik. Setelah panggilan balik ditetapkan, perender memanggil metode dekoder IOverlayNotify ketika peristiwa yang sesuai terjadi. Untuk membatalkan panggilan balik, gunakan metode IOverlay::Unadvise .

Perender video adalah satu-satunya filter yang memanggil metode pada antarmuka ini. Ini dilakukan secara otomatis oleh perender video default. Jika Anda menulis perender video pengganti, Anda harus menggunakan metode pada antarmuka ini jika filter Anda mendukung IOverlay dan antarmuka ini diteruskan ke filter Anda dalam panggilan IOverlay::Advise .

Warisan

Antarmuka IOverlayNotify mewarisi dari antarmuka IUnknown . IOverlayNotify juga memiliki jenis anggota ini:

Metode

Antarmuka IOverlayNotify memiliki metode ini.

IOverlayNotify::OnClipChange Metode OnClipChange menyediakan pemberitahuan bahwa wilayah jendela yang terlihat telah berubah. Sangat penting bahwa perangkat keras overlay apa pun diperbarui untuk mencerminkan perubahan pada wilayah yang terlihat sebelum kembali dari metode ini.
IOverlayNotify::OnColorKeyChange Metode OnColorKeyChange menyediakan pemberitahuan bahwa kunci warna jendela telah berubah.
IOverlayNotify::OnPaletteChange Metode OnPaletteChange memberikan pemberitahuan bahwa palet jendela telah berubah.
IOverlayNotify::OnPositionChange Metode OnPositionChange memberikan pemberitahuan bahwa posisi telah berubah.

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