Metode IMediaEventEx::SetNotifyWindow (control.h)

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 SetNotifyWindow mendaftarkan jendela untuk memproses pemberitahuan peristiwa.

Sintaks

HRESULT SetNotifyWindow(
  [in] OAHWND   hwnd,
  [in] long     lMsg,
  [in] LONG_PTR lInstanceData
);

Parameter

[in] hwnd

Tangani ke jendela, atau NULL untuk berhenti menerima pesan peristiwa.

[in] lMsg

Pesan jendela yang akan diteruskan sebagai pemberitahuan.

[in] lInstanceData

Nilai yang akan diteruskan sebagai parameter lParam untuk pesan lMsg .

Mengembalikan nilai

Mengembalikan S_OK jika berhasil atau E_INVALIDARG jika parameter hwnd bukan handel yang valid ke jendela.

Keterangan

Metode ini menunjuk jendela yang akan memproses pemberitahuan peristiwa. Setiap kali Filter Graph Manager menempatkan peristiwa dalam antrean peristiwa, Filter Graph Manager juga akan memposting pesan ke jendela yang ditunjuk. Parameter hwnd menentukan jendela, dan parameter lMsg menentukan pesan. Aplikasi harus menentukan pesan jendela privat untuk tujuan ini. Parameter lParam pesan diatur ke nilai lInstanceData, dan parameter wParam diatur ke nol.

Ketika jendela menerima pesan, jendela harus memanggil metode IMediaEvent::GetEvent untuk mengambil peristiwa. Peristiwa bersifat asinkron, sehingga antrean mungkin berisi beberapa peristiwa (atau tidak ada). Panggil GetEvent berulang kali, hingga mengembalikan kode kesalahan.

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

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IMediaEventEx

Share via