提供 IStiUSD 接口

  • 项目

WIA 基于 STI 构建。 为了确保 WIA 微型驱动程序与 STI 集成，微型驱动程序必须实现派生自 IStiUSD 接口方法的接口。 此接口必须存在于 WIA 微型驱动程序中。 IStiUSD 接口用于管理设备 (例如加载驱动程序) ，是 IStiDevice 接口方法与静态图像设备通信的方式。 微型驱动程序必须完全实现派生自 IStiUSD：：Initialize 方法的接口，以便由 WIA 服务加载。

通常， IStiUSD 接口方法由 IStiDevice 接口定义的类似命名方法调用。 微型驱动程序通常通过调用相应的内核模式驱动程序来实现 IStiUSD 接口方法。 每个微型驱动程序都必须定义所有接口方法，但如果不需要某个方法，则只需返回STIERR_UNSUPPORTED。

有关微型驱动程序如何实现 IStiUSD 接口的示例，请参阅 wiacam 相机示例微型驱动程序文件IStiUSD.cpp。

下表列出了并描述了 IStiUSD 接口定义的所有方法。 确定必须由 WIA 微型驱动程序实现或有条件实现的方法。

方法 说明
IStiUSD：:D eviceReset 将静态映像设备重置为已知的初始化状态。
IStiUSD：:D iagnostic 在静止映像设备上运行诊断测试。 WIA 微型驱动程序必须实现此方法。
IStiUSD：：Escape 在静态映像设备上执行特定于供应商的 I/O 操作。
IStiUSD：：GetCapabilities 返回静态图像设备的功能。
IStiUSD：：GetLastErrorInfo 返回有关与静止图像设备关联的上一个已知错误的信息。
IStiUSD：：GetNotificationData 返回静态图像设备上最近发生的事件的说明。
IStiUSD：：GetStatus 返回静止图像设备的状态。 如果 WIA 微型驱动程序的设备具有可生成事件的对象（如按钮），则必须实现此方法。
IStiUSD：：Initialize 初始化定义 IStiUSD 接口的 COM 对象的实例。 WIA 微型驱动程序必须实现此方法。
IStiUSD：：LockDevice 锁定设备供调用方独占使用。 WIA 微型驱动程序必须实现此方法。
IStiUSD：：RawReadCommand 从静止图像设备读取命令信息。
IStiUSD：：RawReadData 从静止图像设备读取数据。
IStiUSD：：RawWriteCommand 将命令信息写入静止图像设备。
IStiUSD：：RawWriteData 将数据写入静态图像设备。
IStiUSD：：SetNotificationHandle 指定微型驱动程序应使用的事件句柄来通知设备事件的调用方。 如果 WIA 微型驱动程序的设备具有可生成事件的对象（如按钮），则必须实现此方法。
IStiUSD：：UnLockDevice 关闭设备端口。 WIA 微型驱动程序必须实现此方法。