IMFVirtualCamera::CreateSyncEvent 메서드(mfvirtualcamera.h)

아티클
02/29/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 을 호출해야 합니다.