METODE IMFCaptureEngineOnEventCallback::OnEvent (mfcaptureengine.h)

  • Artikel

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

Lihat juga

IMFCaptureEngineOnEventCallback