IMFVirtualCamera::CreateSyncSemaphore method (mfvirtualcamera.h)

Artikel
08/24/2023

Pembungkus di sekitar metode IKsControl::KsEvent , yang memungkinkan atau menonaktifkan semaphore.

Sintaks

HRESULT CreateSyncSemaphore(
  REFGUID             kseventSet,
  ULONG               kseventId,
  ULONG               kseventFlags,
  HANDLE              semaphoreHandle,
  LONG                semaphoreAdjustment,
  IMFCameraSyncObject **cameraSyncObject
);

Parameter

kseventSet

GUID yang mewakili KSEVENT. Atur bidang.

kseventId

ULONG yang mewakili bidang KSEVENT.Id .

kseventFlags

Satu set bendera bit-bijaksana atau beredar yang mewakili KSEVENT. Bidang bendera .

semaphoreHandle

Handel yang mewakili KSEVENTDATA. Bidang SemaphoreHandle.Semaphore .

semaphoreAdjustment

Nilai penyesuaian yang mewakili KSEVENTDATA. Bidang SemaphoreHandle.Adjustment .

cameraSyncObject

Parameter output yang menerima antarmuka IMFSyncObject . Pemanggil bertanggung jawab untuk merilis objek ini.

Menampilkan nilai

Mengembalikan nilai HRESULT, termasuk tetapi tidak terbatas pada nilai berikut:

Kode kesalahan	Deskripsi
S_OK	Berhasil

Keterangan

Metode ini memungkinkan pemanggil untuk membuat objek semaphore antara pemanggil dan kamera virtual untuk sinkronisasi. Implementasi kamera virtual akan menerima panggilan ke IKsControl::KsEvent ketika API ini dipanggil. IMFCameraSyncObject yang dihasilkan dapat digunakan untuk memblokir peristiwa dari kamera virtual.

Ketika IMFCameraSyncObject diperoleh, pemanggil dapat memilih untuk menggunakan metode IMFCameraSyncObject::WaitOnSignal atau memanggil WaitForSingleObject atau WaitForMultipleObjects pada HANDLE yang disediakan untuk metode CreateSyncObject . Pemanggil tidak boleh menunggu pada keduanya, karena sinyal pada peristiwa hanya dapat diatur sekali oleh driver.

Pemanggil harus memanggil IMFCameraSyncObject::Shutdown ketika objek sinkronisasi tidak lagi diperlukan terlepas dari apakah operasi tunggu berhasil atau tidak.