IStiDevice COM Interface
The IStiDevice COM interface provides applications with the ability to communicate with still image devices. Interface methods allow applications to send and receive data and commands, to run diagnostic tests, to receive notifications of Still Image Device Events, and to obtain device capabilities and status information.
Access to the IStiDevice interface is obtained by calling the CreateDevice method of the IStillImage COM Interface. Many of the IStiDevice interface's methods are implemented by calling like-named methods defined by the IStiUSD COM Interface.
The following table lists and describes all of the methods supplied by the IStiDevice interface. The table indicates the types of clients that typically must call each method.
Method | Description | Typical Callers |
---|---|---|
IStiDevice::DeviceReset | Resets a still image device to a known state. | Image Acquisition APIs |
IStiDevice::Diagnostic | Executes diagnostic tests on a still image device. | Scanners and Cameras Control Panel |
IStiDevice::Escape | Sends a request for a vendor-specific I/O operation to a still image device. | Image Acquisition APIs |
IStiDevice::GetCapabilities | Returns a still image device's capabilities. | Still image event monitor |
IStiDevice::GetLastError | Returns the last known error associated with a still image device. | Image Acquisition APIs |
IStiDevice::GetLastErrorInfo | Returns information about the last known error associated with a still image device. | Image Acquisition APIs |
IStiDevice::GetLastNotificationData | Returns a description of the most recent event that occurred on a still image device. | Image Acquisition APIs |
IStiDevice::GetStatus | Returns a still image device's status information. | Image acquisition APIs and still image event monitor |
IStiDevice::Initialize | Initializes an object instance. | Not called directly |
IStiDevice::LockDevice | Locks a device for exclusive use by the caller. | All IStiDevice interface clients |
IStiDevice::RawReadCommand | Reads command information from a still image device. | Image Acquisition APIs |
IStiDevice::RawReadData | Reads data from a still image device. | Image Acquisition APIs |
IStiDevice::RawWriteCommand | Sends command information to a still image device. | Image Acquisition APIs |
IStiDevice::RawWriteData | Writes data to a still image device. | Image Acquisition APIs |
IStiDevice::Release | Closes an object instance and removes access to the IStiDevice interface. | All IStiDevice interface clients |
IStiDevice::Subscribe | Registers the caller to receive notifications of device events. | Image Acquisition APIs |
IStiDevice::UnLockDevice | Unlocks a device. | All IStiDevice interface clients |
IStiDevice::UnSubscribe | Removes the caller from the list of applications registered to receive notification of device events. | Image Acquisition APIs |