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