IStiUSD::SetNotificationHandle 方法 (stiusd.h)

仍图像微型驱动程序的 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)