Entrées de Registre pour les appareils à image fixe
Microsoft STI utilise plusieurs entrées de Registre, dont certaines peuvent être modifiées par des composants fournis par le fournisseur.
Valeurs de Registre modifiables par le fournisseur
Le tableau suivant répertorie les noms de valeurs de Registre prédéfinis et leur signification. Les constantes sont définies dans stireg.h. Une valeur doit être affectée à « TwainDS » si l’appareil prend en charge le modèle push d’image fixe. Les valeurs des autres noms sont facultatives.
| Constant | Chaîne de nom de valeur | Définition |
|---|---|---|
| STI_DEVICE_VALUE_ICM_PROFILE | « ICMProfile » | REG_MULTI_SZ type contenant des noms de profils ICM pour l’appareil. |
| STI_DEVICE_VALUE_ISIS_NAME | « ISISDriverName » | REG_SZ type contenant le nom du pilote ISIS de l’appareil, par exemple « epson.pxn ». |
| STI_DEVICE_VALUE_TIMEOUT | « PollTimeout » | REG_DWORD type représentant la valeur de délai d’attente, en millisecondes, qui doit être utilisée lors de l’interrogation de l’appareil. La valeur par défaut est de 1000 (1 seconde). |
| STI_DEVICE_VALUE_TWAIN_NAME | « TwainDS » | REG_SZ type contenant le nom affichable de la source de données TWAIN de l’appareil, par exemple « HP PictureScan 3.0 ». |
Les clients de l’interface COM StillImage doivent appeler IStillImage ::SetDeviceValue et IStillImage ::GetDeviceValue pour référencer le Registre. Les minidrivers d’image peuvent appeler l’API de registre Win32, en spécifiant la clé de Registre reçue par la méthode IStiUSD ::Initialize du minidriver. Les valeurs des entrées de Registre prédéfinies peuvent également être définies à partir du fichier INF.
Valeurs de Registre personnalisées
Les applications d’image fixe et les minidrivers peuvent également stocker des valeurs personnalisées et spécifiques à l’appareil dans le registre. Par exemple, les sélections d’utilisateurs obtenues à partir de pages de feuilles de propriétés personnalisées peuvent être stockées sous une sous-clé « UserSettings ».
En outre, les valeurs des entrées de Registre personnalisées peuvent être définies à partir du fichier INF en incluant une entrée DeviceData .
Entrées de Registre non modifiables
Le tableau suivant répertorie les entrées de Registre qui ne doivent pas être modifiées par le logiciel fournisseur.
| Clé de Registre | Définition |
|---|---|
| HKLM\SYSTEM\CurrentControlSet\Control\StillImage\Logging\STICLI | Spécifie les messages générés par le fournisseur qui sont écrits dans le fichier journal d’images fixes. Il peut s’agir de n’importe quelle combinaison des masques de bits suivants : 0x1 : messages d’information 0x2 - messages d’avertissement 0x4 : messages d’erreur Consultez IStillImage ::WriteToErrorLog. |
| HKLM\SYSTEM\CurrentControlSet\Control\StillImage\Logging\STIMON | Spécifie les messages du moniteur d’événements qui sont écrits dans le fichier journal de l’image fixe. Il peut s’agir de n’importe quelle combinaison des masques de bits suivants : 0x1 : messages d’information 0x2 - messages d’avertissement 0x4 : messages d’erreur |
| HKLM\SYSTEM\CurrentControlSet\Control\Class{6BDD1FC6-810F-11D0-BEC7-08002BE2092F} | Contient des informations sur les appareils à image fixe installés. |
| HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\StillImage\Registered Applications | Contient une liste d’applications de création d’images inscrites. |
| HKLM\SYSTEM\CurrentControlSet\Control\DeviceClass{6bdd1fc6-810f-11d0-bec7-08002be2092f} | Contient des informations sur les interfaces d’appareil d’image fixe installées. |