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)

另请参阅

IStiDevice

IStiDevice::UnSubscribe

IStillImage::LaunchApplicationForDevice