Antarmuka IOverlay (strmif.h)

[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.]

Antarmuka IOverlay menyediakan informasi sehingga filter dapat menulis langsung ke memori video saat menempatkan video dalam posisi jendela yang benar. Ini diimplementasikan pada pin input perender video dan berkomunikasi dengan filter upstream (biasanya dekompresor video) dengan memanggil metode IOverlayNotify filter tersebut untuk memberi tahunya tentang perubahan pada jendela video.

Antarmuka ini tidak memiliki hubungan dengan kemampuan overlay DirectDraw®. Perender video Microsoft menarik data yang diterimanya melalui antarmuka IMemInputPin , menggunakan overlay DirectDraw saat tersedia. Antarmuka ini, yang digunakan sebagai pengganti IMemInputPin, dimaksudkan untuk memberikan dukungan pemberitahuan untuk filter upstram apa pun yang melewati kemampuan menggambar perender, tetapi memerlukan pemberitahuan properti tampilan lainnya.

Lihat halaman referensi IOverlayNotify untuk informasi selengkapnya tentang cara IOverlay antarmuka IOverlayNotify dan bekerja sama.

Lihat antarmuka IOverlayNotify2 untuk informasi selengkapnya tentang pemberitahuan perubahan asinkron pada jendela penyajian.

Antarmuka ini diimplementasikan pada filter perender video Microsoft® DirectShow®. Ini juga dapat diimplementasikan pada filter perender video pengganti jika diinginkan. Jika melakukannya, terapkan antarmuka ini sehingga filter menulis langsung ke buffer bingkai atau mencoba memposisikan overlay yang tahu di mana menampilkan video mereka. Untuk mengimplementasikan antarmuka ini, perender harus siap menggunakan metode pada antarmuka IOverlayNotify atau antarmuka IOverlayNotify2 dari filter yang melakukan gambar, dengan pemberitahuan perubahan properti video.

Perender berbasis jendela di DirectShow mendukung antarmuka IMemInputPin dan IOverlay . Kedua antarmuka ini saling eksklusif. Filter memilih untuk menggunakan transportasi IOverlay dengan menyediakan jenis media selama koneksi yang memiliki subjenis MEDIASUBTYPE_Overlay. Setelah koneksi, ia akan dapat mendapatkan dan menggunakan antarmuka dengan IOverlay sukses. Jika tersambung dengan format video lain (seperti MEDIASUBTYPE_RGB8), mencoba memanggil melalui IOverlay mengembalikan VFW_E_NOT_OVERLAY_CONNECTION.

Gunakan metode pada fungsi ini dari filter upstream yang harus mengontrol properti overlay video dan berniat untuk menangani tampilan data video itu sendiri. Ini biasanya digunakan oleh dekode video perangkat keras yang memiliki koneksi alternatif ke perangkat keras video.

Warisan

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

Metode

Antarmuka IOverlay memiliki metode ini.

IOverlay::Advise Metode Saran menyiapkan tautan saran untuk peristiwa overlay yang ditentukan oleh parameter dwInterests.
IOverlay::GetClipList Metode GetClipList mengambil daftar kliping.
IOverlay::GetColorKey Metode GetColorKey mengambil kunci warna saat ini yang digunakan untuk kunci klorma.
IOverlay::GetDefaultColorKey Metode GetDefaultColorKey mengambil kunci warna default yang digunakan untuk overlay kunci klorma.
IOverlay::GetPalette Metode GetPalette mengambil palet sistem saat ini.
IOverlay::GetVideoPosition Metode GetVideoPosition mengambil sumber video dan persegi panjang tujuan saat ini.
IOverlay::GetWindowHandle Metode GetWindowHandle mengambil handel jendela saat ini.
IOverlay::SetColorKey Metode SetColorKey mengubah kunci warna.
IOverlay::SetPalette Metode SetPalette mengatur palet.
IOverlay::Unadvise Metode Unadvise mengakhiri tautan saran yang dibuat dengan antarmuka IOverlayNotify.

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)