Registry entries for still image devices
Microsoft STI makes use of several registry entries, some of which can be modified by vendor-supplied components.
Vendor-modifiable registry values
The following table lists the predefined registry value names and their meanings. Constants are defined in stireg.h. A value must be assigned to "TwainDS" if the device supports the still image push model. Values for the other names are optional.
| Constant | Value name string | Definition |
|---|---|---|
| STI_DEVICE_VALUE_ICM_PROFILE | "ICMProfile" | REG_MULTI_SZ type containing names of ICM profiles for the device. |
| STI_DEVICE_VALUE_ISIS_NAME | "ISISDriverName" | REG_SZ type containing the device's ISIS driver name, such as "epson.pxn". |
| STI_DEVICE_VALUE_TIMEOUT | "PollTimeout" | REG_DWORD type representing the time-out value, in milliseconds, that should be used when polling the device. The default value is 1000 (1 second). |
| STI_DEVICE_VALUE_TWAIN_NAME | "TwainDS" | REG_SZ type containing the displayable name of the device's TWAIN data source, such as "HP PictureScan 3.0". |
Clients of the StillImage COM interface should call IStillImage::SetDeviceValue and IStillImage::GetDeviceValue to reference the registry. Still image minidrivers can call the Win32 registry API, specifying the registry key received by the minidriver's IStiUSD::Initialize method. Values for predefined registry entries can also be set from within the INF file.
Customized registry values
Still image applications and minidrivers can also store customized, device-specific values in the registry. For example, user selections obtained from customized property sheet pages could be stored under a "UserSettings" subkey.
Additionally, values for customized registry entries can be set from within the INF file by including a DeviceData entry.
Non-modifiable registry entries
The following table lists registry entries that should not be modified by vendor software.
| Registry Key | Definition |
|---|---|
| HKLM\SYSTEM\CurrentControlSet\Control\StillImage\Logging\STICLI | Specifies which vendor-generated messages are written to the still image log file. Can be any combination of the following bitmasks: 0x1 - informational messages 0x2 - warning messages 0x4 - error messages See IStillImage::WriteToErrorLog. |
| HKLM\SYSTEM\CurrentControlSet\Control\StillImage\Logging\STIMON | Specifies which event monitor messages are written to the still image log file. Can be any combination of the following bitmasks: 0x1 - informational messages 0x2 - warning messages 0x4 - error messages |
| HKLM\SYSTEM\CurrentControlSet\Control\Class{6BDD1FC6-810F-11D0-BEC7-08002BE2092F} | Contains information about installed still image devices. |
| HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\StillImage\Registered Applications | Contains a list of registered imaging applications. |
| HKLM\SYSTEM\CurrentControlSet\Control\DeviceClass{6bdd1fc6-810f-11d0-bec7-08002be2092f} | Contains information about installed still image device interfaces. |