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 组合:

标志 含义
INITIAL_EVENT_SIGNALED 设置此标志以指示事件对象的信号状态。 否则,事件的初始状态不对齐。
NOTIFICATION_EVENT 设置此标志以创建通知事件。 如果未设置此标志,则会创建同步事件。

[in] Unused

视频端口驱动程序当前忽略,必须设置为 NULL

[out] ppEvent

指向将返回指向事件对象的指针的内存位置的指针的指针。

返回值

如果成功创建事件对象,VideoPortCreateEvent 将返回NO_ERROR。

注解

当同步事件设置为已发出信号的状态时,将释放等待信号状态的单个线程, (其调度状态从等待状态转换为就绪、待机或运行) ,并且事件会自动重置为未对齐状态。

当通知事件设置为已发出信号的状态时,所有等待信号状态的线程都会释放,并且事件将保持为已发出信号的状态,直到它被显式重置为未对齐状态。

要求

要求
最低受支持的客户端 在 Windows XP 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 video.h (包括 Video.h)
Library Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

另请参阅

VideoPortDeleteEvent