Metodo IMFVirtualCamera::CreateSyncEvent (mfvirtualcamera.h)

Articolo
02/29/2024

Wrapper intorno al metodo IKsControl::KsEvent , che abilita o disabilita un evento.

Sintassi

HRESULT CreateSyncEvent(
  REFGUID             kseventSet,
  ULONG               kseventId,
  ULONG               kseventFlags,
  HANDLE              eventHandle,
  IMFCameraSyncObject **cameraSyncObject
);

Parametri

kseventSet

GUID che rappresenta il KSEVENT. Impostare il campo.

kseventId

ULONG che rappresenta il campo KSEVENT.Id .

kseventFlags

Set di flag bit-wise o ed che rappresentano il KSEVENT. Campo Contrassegni .

eventHandle

Handle che rappresenta KSEVENTDATA. Campo EventHandle.Event .

cameraSyncObject

Parametro di output che riceve un'interfaccia IMFSyncObject . Il chiamante è responsabile del rilascio di questo oggetto.

Valore restituito

Restituisce un valore HRESULT, incluso ma non limitato ai valori seguenti:

Codice di errore	Descrizione
S_OK	Completato

Commenti

Questo metodo consente al chiamante di creare un oggetto evento tra il chiamante e la fotocamera virtuale per la sincronizzazione. L'implementazione della fotocamera virtuale riceverà una chiamata a IKsControl::KsEvent quando questa API viene chiamata. L'oggetto FMCameraSyncObject risultante può essere usato per bloccare l'evento dalla fotocamera virtuale.

Quando viene ottenuto l'oggetto IMFCameraSyncObject, il chiamante può scegliere di usare il metodo IMFCameraSyncObject::WaitOnSignal o chiamare WaitForSingleObjects nel metodo HANDLE fornito al metodo CreateSyncObject. Il chiamante non deve attendere entrambi, poiché il segnale sull'evento può essere impostato una sola volta dal driver.

Il chiamante deve chiamare IMFCameraSyncObject::Shutdown quando l'oggetto di sincronizzazione non è più necessario indipendentemente dal fatto che l'operazione di attesa abbia esito positivo o meno.