Método IMFVirtualCamera::CreateSyncEvent (mfvirtualcamera.h)

Artigo
02/29/2024

Um wrapper ao redor do método IKsControl::KsEvent , que habilita ou desabilita um evento.

Sintaxe

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

Parâmetros

kseventSet

Um GUID que representa o KSEVENT. Definir campo.

kseventId

Um ULONG que representa o campo KSEVENT.Id .

kseventFlags

Um conjunto de sinalizadores bit a bit ou ed que representam o KSEVENT. Campo Sinalizadores .

eventHandle

Um Identificador que representa o KSEVENTDATA. Campo EventHandle.Event .

cameraSyncObject

Um parâmetro de saída que recebe uma interface IMFSyncObject . O chamador é responsável por liberar esse objeto.

Retornar valor

Retorna um valor HRESULT, incluindo, mas não se limitando aos seguintes valores:

Código do erro	Descrição
S_OK	Com sucesso

Comentários

Esse método permite que o chamador crie um objeto de evento entre o chamador e a câmera virtual para sincronização. A implementação da câmera virtual receberá uma chamada para IKsControl::KsEvent quando essa API for chamada. O IMFCameraSyncObject resultante pode ser usado para bloquear o evento da câmera virtual.

Quando IMFCameraSyncObject for obtido, o chamador poderá optar por usar o método IMFCameraSyncObject::WaitOnSignal ou chamar WaitForSingleObject ou WaitForMultipleObjects no HANDLE que foi fornecido ao método CreateSyncObject . O chamador não deve esperar em ambos, pois o sinal no evento só pode ser definido uma vez pelo driver.

O chamador deve chamar IMFCameraSyncObject::Shutdown quando o objeto de sincronização não for mais necessário, independentemente de a operação de espera ter sido bem-sucedida ou não.