Функция VideoPortCreateEvent (video.h)

Статья
02/07/2025

Функция VideoPortCreateEvent создает объект события.

Синтаксис

VIDEOPORT_API VP_STATUS VideoPortCreateEvent(
  [in]  IN PVOID   HwDeviceExtension,
  [in]  IN ULONG   EventFlag,
  [in]  IN PVOID   Unused,
  [out] OUT PEVENT *ppEvent
);

Параметры

[in] HwDeviceExtension

Указатель на расширение устройства минипорта драйвера.

[in] EventFlag

Указывает тип события и начальное состояние события. Это может быть комбинация ORed следующих флагов:

Флаг	Значение
INITIAL_EVENT_SIGNALED	Задайте этот флаг, чтобы указать сигнальное состояние объекта события. В противном случае начальное состояние события не назначено.
NOTIFICATION_EVENT	Задайте этот флаг для создания события уведомления. Если этот флаг не задан, создается событие синхронизации.

[in] Unused

В настоящее время драйвер видеопорта игнорируется и должен иметь значение NULL.

[out] ppEvent

Указатель на расположение памяти, в котором будет возвращен указатель на объект события.

Возвращаемое значение

VideoPortCreateEvent возвращает NO_ERROR, если объект события успешно создан.

Замечания

Если для события синхронизации задано сигнальное состояние, освобождается один поток, ожидающий сигнального состояния (его состояние отправки переходит от ожидания до готовности, ожидания или выполнения), а событие автоматически сбрасывается в состояние без знака.

Если событие уведомления установлено для сигнального состояния, все потоки, ожидающие сигнального состояния, освобождаются, и событие остается в сигнальном состоянии, пока оно не будет явно сброшено в незначаемое состояние.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows XP и более поздних версиях операционных систем Windows.
целевая платформа	Настольный
заголовка	video.h (include Video.h)
библиотеки	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

См. также

VideoPortDeleteEvent

Поделиться через