IMFVirtualCamera：：CreateSyncEvent 方法 (mfvirtualcamera.h)

發行項
03/13/2024

IKsControl：：KsEvent 方法的包裝函式，可啟用或停用事件。

語法

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

參數

kseventSet

代表 KSEVENT 的 GUID。設定欄位。

kseventId

代表 [KSEVENT.Id ] 字段的 ULONG。

kseventFlags

代表 KSEVENT 的一組位或ed 旗標 。[旗標] 欄位。

eventHandle

代表 KSEVENTDATA 的句柄。EventHandle.Event 字段。

cameraSyncObject

接收 IMFSyncObject 介面的輸出參數。呼叫端負責釋放此物件。

傳回值

傳回 HRESULT 值，包括但不限於下列值：

錯誤碼	描述
S_OK	成功

備註

這個方法可讓呼叫端在呼叫端與虛擬相機之間建立事件物件，以進行同步處理。呼叫此 API 時，虛擬相機實作會收到 IKsControl：：KsEvent 的呼叫。產生的 IMFCameraSyncObject 可用來封鎖虛擬相機的事件。

取得 IMFCameraSyncObject 時，呼叫端可以選擇使用 IMFCameraSyncObject：：WaitOnSignal 方法，或在提供給 CreateSyncObject 方法的 HANDLE 上呼叫 WaitForSingleObject 或 WaitForMultipleObjects。呼叫端不得等候這兩者，因為事件上的訊號只能由驅動程式設定一次。

無論等候作業是否成功，呼叫端都必須在不再需要同步處理物件時呼叫 IMFCameraSyncObject：：Shutdown 。