通过

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 ，以通知事件监视器已发生事件。

如果 hEvent 为 NULL，则 方法应禁用设备事件的通知。

要求

要求 值
目标平台 桌面
标头 stiusd.h (包括 Stiusd.h)