IMFVirtualCamera::CreateSyncEvent-Methode (mfvirtualcamera.h)

Artikel
08/24/2023

Ein Wrapper um die IKsControl::KsEvent-Methode , die ein Ereignis aktiviert oder deaktiviert.

Syntax

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

Parameter

kseventSet

Eine GUID, die das KSEVENT darstellt. Feld festlegen .

kseventId

Eine ULONG, die das KSEVENT.Id Feld darstellt.

kseventFlags

Eine Reihe bitweiser oder ed-Flags, die das KSEVENT darstellen. Feld "Flags ".

eventHandle

Ein Handle, der das KSEVENTDATA darstellt. EventHandle.Event-Feld .

cameraSyncObject

Ein Ausgabeparameter, der eine IMFSyncObject-Schnittstelle empfängt . Der Aufrufer ist für die Freigabe dieses Objekts verantwortlich.

Rückgabewert

Gibt einen HRESULT-Wert zurück, einschließlich, aber nicht beschränkt auf die folgenden Werte:

Fehlercode	BESCHREIBUNG
S_OK	Erfolgreich

Hinweise

Mit dieser Methode kann der Aufrufer ein Ereignisobjekt zwischen dem Aufrufer und der virtuellen Kamera für die Synchronisierung erstellen. Die Implementierung der virtuellen Kamera erhält einen Aufruf von IKsControl::KsEvent , wenn diese API aufgerufen wird. Das resultierende IMFCameraSyncObject kann verwendet werden, um das Ereignis von der virtuellen Kamera zu blockieren.

Wenn das IMFCameraSyncObject abgerufen wird, kann der Aufrufer die IMFCameraSyncObject::WaitOnSignal-Methode verwenden oder WaitForSingleObject oder WaitForMultipleObjects für das HANDLE aufrufen, das für die CreateSyncObject-Methode bereitgestellt wurde. Der Aufrufer darf nicht auf beide warten, da das Signal für das Ereignis nur einmal vom Treiber eingestellt werden kann.

Der Aufrufer muss IMFCameraSyncObject:Shutdown aufrufen, wenn das Synchronisierungsobjekt nicht mehr benötigt wird, unabhängig davon, ob der Wartevorgang erfolgreich war oder nicht.