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