Metode IMediaEventEx::SetNotifyWindow (control.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.]
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 |