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

Функция 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 следующих флагов:

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

[in] Unused

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

[out] ppEvent

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

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows XP и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть video.h (включить Video.h)
Библиотека Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

См. также раздел

VideoPortDeleteEvent