ICodecAPI::Metode RegisterForEvent (icodecapi.h)

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

  • Last updated on