ICodecAPI::Metode RegisterForEvent (icodecapi.h)

Artikel
08/24/2023

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.	Implementasi tergantung.

[out] userData

Arahkan ke data yang ditentukan penelepon. Aplikasi menerima pointer ini di parameter peristiwa lParam1 .

Mengembalikan nilai

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 acara, 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 didefinisikan dalam codecapi.h.	Tidak ada.
GUID peristiwa kepemilikan.	Implementasi tergantung.

Jika codec tidak mendukung peristiwa yang ditentukan, metode 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 10 Build 20348
Server minimum yang didukung	Windows 10 Build 20348
Header	icodecapi.h

Lihat juga

Referensi API Codec

Encoder API

ICodecAPI

Bagikan melalui