ICodecAPI::Metode RegisterForEvent (strmif.h)

Artikel
07/28/2023

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

Metode RegisterForEvent mendaftarkan aplikasi untuk menerima peristiwa dari codec.

Sintaks

HRESULT RegisterForEvent(
  [in]  const GUID *Api,
  [out] LONG_PTR   userData
);

Parameter

[in] Api

Penunjuk ke GUID yang menentukan peristiwa. Ada tiga kategori peristiwa:

Nilai	Makna
CODECAPI_CHANGELISTS	Codec memberi tahu aplikasi ketika properti codec berubah. Data peristiwa adalah daftar GUID untuk properti yang berubah.
Salah satu GUID properti yang ditentukan dalam codecapi.h. (Lihat Properti API Codec.)	Codec memberi tahu aplikasi ketika properti yang ditentukan berubah. Biasanya, codec akan mendukung jenis pemberitahuan ini untuk sekumpulan properti terbatas, jika ada.
GUID peristiwa kepemilikan yang ditentukan oleh codec.	Dependen implementasi.

[out] userData

Arahkan ke data yang ditentukan pemanggil. Aplikasi menerima pointer ini dalam parameter peristiwa lParam1 .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_NOTIMPL	Tidak diterapkan. Codec tidak mendukung pemberitahuan peristiwa, atau tidak mendukung GUID peristiwa yang ditentukan dalam parameter Api .

Keterangan

Aplikasi menerima pemberitahuan peristiwa EC_CODECAPI_EVENT setiap kali codec encoder mengirim peristiwa. Untuk mendapatkan peristiwa, gunakan antarmuka IMediaEventEx .

Parameter lParam2 dari peristiwa adalah penunjuk ke struktur CodecAPIEventData . Struktur ini dapat diikuti oleh data tambahan, tergantung pada GUID peristiwa. Ukuran data ini diberikan oleh anggota dataLength .

GUID	Data Peristiwa
CODECAPI_CHANGELISTS	Array GUID. Setiap GUID menentukan properti codec yang nilainya saat ini atau rentang valid telah berubah. Ukuran array adalah dataLength / `sizeof(GUID)`.
GUID properti yang ditentukan dalam codecapi.h.	Tidak ada.
GUID peristiwa kepemilikan.	Dependen implementasi.

Jika codec tidak mendukung peristiwa yang ditentukan, metode akan mengembalikan E_NOTIMPL. Codec mungkin mendukung peristiwa lain.

Untuk menonaktifkan pemberitahuan untuk suatu peristiwa, panggil ICodecAPI::UnregisterForEvent.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Referensi API Codec

Encoder API

ICodecAPI

Bagikan melalui