Метод IMFVirtualCamera::CreateSyncEvent (mfvirtualcamera.h)
Оболочка вокруг метода IKsControl::KsEvent , которая включает или отключает событие.
Синтаксис
HRESULT CreateSyncEvent(
REFGUID kseventSet,
ULONG kseventId,
ULONG kseventFlags,
HANDLE eventHandle,
IMFCameraSyncObject **cameraSyncObject
);
Параметры
kseventSet
Идентификатор GUID, представляющий KSEVENT. Задать поле.
kseventId
Объект ULONG, представляющий поле KSEVENT.Id .
kseventFlags
Набор битовых или ed флагов, представляющих KSEVENT. Поле "Флаги ".
eventHandle
Дескриптор, представляющий KSEVENTDATA. Поле EventHandle.Event .
cameraSyncObject
Выходной параметр, получающий интерфейс IMFSyncObject . Вызывающий объект отвечает за освобождение этого объекта.
Возвращаемое значение
Возвращает значение HRESULT, включая, помимо прочего, следующие значения:
| Код ошибки | Описание |
|---|---|
| S_OK | Выполнено |
Комментарии
Этот метод позволяет вызывающей объекту создать объект события между вызывающим объектом и виртуальной камерой для синхронизации. Реализация виртуальной камеры будет получать вызов IKsControl::KsEvent при вызове этого API. Полученный объект IMFCameraSyncObject можно использовать для блокировки события с виртуальной камеры.
При получении объекта IMFCameraSyncObject вызывающий объект может использовать метод IMFCameraSyncObject::WaitOnSignal или метод WaitForSingleObject или WaitForMultipleObjects в методе HANDLE, предоставленном методу CreateSyncObject . Вызывающий объект не должен ждать обоих, так как сигнал для события может быть задан драйвером только один раз.
Вызывающий объект должен вызвать IMFCameraSyncObject::Shutdown , если объект синхронизации больше не требуется, независимо от того, успешно ли выполнена операция ожидания.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Сборка Windows 22000 |
| Верхняя часть | mfvirtualcamera.h |
| Библиотека | mfsensorgroup.lib |
| DLL | mfsensorgroup.dll |