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 |