仍图像微型驱动程序的 IStiUSD::SetNotificationHandle 方法指定微型驱动程序应用于通知设备事件的调用方的事件句柄。
语法
HRESULT SetNotificationHandle(
HANDLE hEvent
);
参数
hEvent
调用方提供的 Win32 事件的句柄,通过调用 CreateEvent创建。
返回值
如果作成功,该方法应返回S_OK。 否则,它应返回 stierr.h中定义的 STIERR 前缀错误代码之一。
言论
如果驱动程序(和设备)支持 静止图像设备事件的异步通知,则微型驱动程序的 IStiUSD::SetNotificationHandle 方法就是事件监视器请求驱动程序在事件发生时通知它的方法。
如果 hEvent 是事件句柄,IStiUSD::SetNotificationHandle 方法应存储句柄并将其用作输入参数来 SetEvent(Microsoft Windows SDK 文档中所述)。 驱动程序应在每次检测到设备事件时调用 SetEvent,以通知事件监视器已发生事件。
如果 hEventNULL,则该方法应禁用设备事件的通知。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | stiusd.h (包括 Stiusd.h) |