IOverlay::Metode saran (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 Advise ini menyiapkan tautan saran untuk peristiwa overlay yang ditentukan oleh parameter dwInterests .

Sintaks

HRESULT Advise(
  [in] IOverlayNotify *pOverlayNotify,
  [in] DWORD          dwInterests
);

Parameter

[in] pOverlayNotify

Arahkan ke antarmuka pemberitahuan.

[in] dwInterests

Panggilan balik yang menarik, yang dapat menjadi subset dari peristiwa berikut.

Kejadian Deskripsi
ADVISE_NONE Tidak ada perubahan.
ADVISE_CLIPPING Perubahan wilayah kliping (disinkronkan dengan jendela).
ADVISE_PALETTE Perubahan palet.
ADVISE_COLORKEY Perubahan nilai kunci klorma.
ADVISE_POSITION Ubah posisi jendela video (tidak disinkronkan dengan jendela).
ADVISE_DISPLAY_CHANGE Memanggil WM_DISPLAYCHANGE. Pesan WM_DISPLAYCHANGE dikirim ke semua jendela ketika resolusi tampilan telah berubah.
ADVISE_ALL2 Semua di atas.

Mengembalikan nilai

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

Keterangan

Metode ini menyiapkan tautan saran untuk antarmuka IOverlayNotify untuk menerima pemberitahuan. Jika salah satu peristiwa ini terjadi, titik masuk yang sesuai dalam parameter pOverlayNotify yang diteruskan dipanggil (IOverlayNotify::OnClipChange, IOverlayNotify::OnColorKeyChange, IOverlayNotify::OnPaletteChange, atau IOverlayNotify::OnPositionChange).

Hanya satu tautan saran yang dapat diatur pada antarmuka IOverlay tertentu. Mencoba mengatur antarmuka pemberitahuan lain pada panggilan kedua dan berikutnya mengembalikan VFW_E_ADVISE_ALREADY_SET. Anda dapat membatalkan tautan saran dengan menggunakan IOverlay::Unadvise.

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)
Pustaka Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IOverlay