提供 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 微型驱动程序必须实现此方法。 |