IStiDevice::Subscribe 方法 (sti.h)
IStiDevice::Subscribe 方法注册调用方以接收设备事件的通知。
语法
HRESULT Subscribe(
[in, out] LPSTISUBSCRIBE lpSubsribe
);
参数
[in, out] lpSubsribe
调用方提供的指向包含订阅参数值的 STISUBSCRIBE 结构的指针。
返回值
如果操作成功,该方法将返回S_OK。 否则,它将返回 stierr.h 中定义的 STIERR 前缀错误代码之一。
注解
IStiDevice::Subscribe 方法通常由截获设备中的事件并重新路由的应用程序调用。 方法允许这些应用程序收到 静态图像设备事件的 通知,以便他们可以将控制权调度到相应的显示应用程序。
根据 STISUBSCRIBE 结构中提供的内容,调用方可以请求通过 Windows 消息或 Win32 事件 (通过 SetEvent 调用) 通知设备事件。
当应用程序收到事件的通知时,它可以调用 IStiDevice::GetLastNotificationData 来找出发生的事件。
在调用 IStiDevice::Subscribe 之前, IStiDevice COM 接口的客户端必须调用 IStillImage::CreateDevice 以获取 IStiDevice 接口指针,该指针提供对指定设备的访问权限。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | sti.h (包括 Sti.h) |