IStillImage COM interface
The IStillImage COM interface provides access to the Still image event monitor so applications can register themselves as "push-model aware". Applications can use this interface to obtain information about the system's still image devices.
The interface provides some application management functions, such as enabling event notification and starting an application, for use by customized application control software.
Additionally, the IStillImage interface provides access to the IStiDevice COM interface, which allows applications to perform I/O operations on still image devices.
The following table lists and describes all of the IStillImage interface's methods. The table indicates the types of clients that typically must call each method.
| Method | Description | Typical callers |
|---|---|---|
| IStillImage::CreateDevice | Creates an instance of the COM object that defines the IStiDevice interface, and returns a pointer to the interface. | Image Acquisition APIs |
| IStillImage::EnableHwNotifications | Enables or disables the notification of applications when Still Image Device Events occur for a specified device. | Still image event monitor |
| IStillImage::GetDeviceInfo | Returns hardware characteristics for a specified still image device. | Image Acquisition APIs |
| IStillImage::GetDeviceList | Returns hardware characteristics for all installed still image devices. | Scanners and Cameras Control Panel, Image Acquisition APIs |
| IStillImage::GetDeviceValue | Returns registry information associated with a specified still image device. | Image Acquisition APIs, Scanners and Cameras Control Panel |
| IStillImage::GetHwNotificationState | Indicates whether applications will be notified when still image device events occur on a specified device. | Still image event monitor |
| IStillImage::GetSTILaunchInformation | Returns the reason the calling still image application was started, if the still image event monitor started it. | Push-model aware applications |
| IStillImage::Initialize | Initializes the object instance. | Not called directly |
| IStillImage::LaunchApplicationForDevice | Starts a specified application for a specified still image device. | Still image event monitor |
| IStillImage::RegisterLaunchApplication | Adds an application to the still image event monitor's list of push-model aware applications. | Push-model aware applications or their installers |
| IStillImage::Release | Closes the object instance and removes access to the IStillImage interface. | All IStillImage interface clients |
| IStillImage::SetDeviceValue | Sets registry information for a specified still image device. | Scanners and Cameras Control Panel |
| IStillImage::SetupDeviceParameters | Allows clients of the IStillImage interface to modify a still image device's stored characteristics. | Scanners and Cameras Control Panel |
| IStillImage::StiCreateInstance | Creates an instance of the COM object that defines the IStillImage interface, and returns a pointer to the interface. | All IStillImage interface clients |
| IStillImage::UnregisterLaunchApplication | Removes an application from the still image event monitor's list of push-model aware applications. | Push-model aware applications or their installers |
| IStillImage::WriteToErrorLog | Writes a message to the still image error log. | All IStillImage interface clients |