METODE IMFCaptureEngineOnEventCallback::OnEvent (mfcaptureengine.h)
Dipanggil oleh mesin penangkap untuk memberi tahu aplikasi peristiwa penangkapan.
Sintaks
HRESULT OnEvent(
[in] IMFMediaEvent *pEvent
);
Parameter
[in] pEvent
Penunjuk ke antarmuka IMFMediaEvent . Gunakan antarmuka ini untuk mendapatkan informasi tentang peristiwa, seperti yang dijelaskan dalam Keterangan.
Menampilkan nilai
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Untuk mendapatkan jenis peristiwa, panggil IMFMediaEvent::GetExtendedType. Metode ini mengembalikan salah satu GUID berikut.
| GUID | Deskripsi |
|---|---|
| MF_CAPTURE_ENGINE_ALL_EFFECTS_REMOVED | Metode IMFCaptureSource::RemoveAllEffects selesai. |
| MF_CAPTURE_ENGINE_CAMERA_STREAM_BLOCKED | Pengambilan video telah diblokir oleh driver. |
| MF_CAPTURE_ENGINE_CAMERA_STREAM_UNBLOCKED | Pengambilan video telah dipulihkan oleh driver setelah diblokir. |
| MF_CAPTURE_ENGINE_EFFECT_ADDED | Metode IMFCaptureSource::AddEffect selesai. |
| MF_CAPTURE_ENGINE_EFFECT_REMOVED | Metode IMFCaptureSource::RemoveEffect selesai. |
| MF_CAPTURE_ENGINE_ERROR | Terjadi kesalahan selama pengambilan. |
| MF_CAPTURE_ENGINE_INITIALIZED | Metode IMFCaptureEngine::Initialize selesai. |
| MF_CAPTURE_ENGINE_PHOTO_TAKEN | Metode IMFCaptureEngine::TakePhoto selesai. |
| MF_CAPTURE_ENGINE_PREVIEW_STARTED | Metode IMFCaptureEngine::StartPreview selesai. |
| MF_CAPTURE_ENGINE_PREVIEW_STOPPED | Metode IMFCaptureEngine::StopPreview selesai. |
| MF_CAPTURE_ENGINE_RECORD_STARTED | Metode IMFCaptureEngine::StartRecord selesai. |
| MF_CAPTURE_ENGINE_RECORD_STOPPED | Metode IMFCaptureEngine::StopRecord selesai. |
| MF_CAPTURE_SINK_PREPARED | Metode IMFCaptureSink::P repare selesai. |
| MF_CAPTURE_SOURCE_CURRENT_DEVICE_MEDIA_TYPE_SET | Metode IMFCaptureSource::SetCurrentDeviceMediaType selesai. |
Metode ini dapat dipanggil dari utas pekerja. Implementasinya harus aman untuk utas.
Untuk mendapatkan kode status untuk peristiwa tersebut, panggil IMFMediaEvent::GetStatus. Jika kode status adalah kode kesalahan, itu menunjukkan bahwa operasi yang diminta gagal.
Selain itu, objek peristiwa yang ditentukan oleh pEvent mungkin berisi salah satu atribut berikut.
Untuk mendapatkan atribut peristiwa, gunakan antarmuka IMFAttributes , yang diwarisi IMFMediaEvent .Persyaratan
| Klien minimum yang didukung | Windows 8 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | mfcaptureengine.h |