Partager via

Fichiers INF pour les appareils à image fixe

  • Article

Le programme d’installation de classe par défaut pour les appareils à image fixe, sti_ci.dll, reconnaît un ensemble spécial d’entrées de fichier INF. Dans un fichier INF, ces entrées doivent être placées dans la section INF DDInstall d’un appareil. Les entrées sont décrites dans le tableau suivant.

Entrée de fichier INF Valeur Commentaires
Sous-classe StillImage Obligatoire
DeviceType 1 pour les scanneurs, 2 pour les caméras, 3 pour les appareils vidéo Obligatoire
DeviceSubType Valeur définie par le fournisseur Facultatif
Connexion Pour les appareils non PnP connectés à des ports série ou parallèles, cela peut être Série ou Parallèle pour limiter le choix des ports de l’utilisateur lors de l’installation. facultatif.
S’il n’est pas spécifié, l’utilisateur peut sélectionner n’importe quel port série ou parallèle.
Fonctionnalités Spécifie un nombre converti en indicateurs de bits identifiant les fonctionnalités de l’appareil. Ces indicateurs sont stockés dans le Registre et sont disponibles pour les composants Microsoft STI avec la structure STI_DEV_CAPS .

Bit 0 − Définit/efface les STI_GENCAP_NOTIFICATIONS dans STI_DEV_CAPS
Bit 1 − Définit/efface les STI_GENCAP_POLLING_NEEDED dans STI_DEV_CAPS
Bit 2 − Définit/efface les STI_GENCAP_GENERATE_ARRIVALEVENT dans STI_DEV_CAPS
Bit 3 − Définit/efface les STI_GENCAP_AUTO_PORTSELECT dans STI_DEV_CAPS		 Facultatif
PropertyPages Identifie le nom et le point d’entrée d’une DLL qui crée des pages de feuilles de propriétés personnalisées pour les appareils à image fixe.
L’exemple suivant identifie la DLL, estp2cpl.dllet le point d’entrée EnumStiPropPages dans cette DLL. Le nom du point d’entrée est facultatif ; s’il est omis, le point d’entrée est enumStiPropPages par défaut.

PropertyPages = estp2cpl.dll, EnumStiPropPages

 Facultatif
DeviceData Identifie une section de données fournie par le fournisseur contenant des informations à stocker dans le Registre, sous la clé DeviceData . Pour les appareils pris en charge par TWAIN, la section données doit contenir une entrée TwainDS . Pour plus d’informations, consultez Valeurs de Registre modifiables par le fournisseur. facultatif.
Toutefois, cette entrée est requise pour la création d’applications Push-Model prenant en charge.
Événements Identifie une section de données fournie par le fournisseur répertoriant les événements d’appareil à image fixe. Chaque entrée de cette section doit avoir le format suivant :

EventName="String",{GUID},App

EventName est le nom interne de l’événement, String est la chaîne d’affichage de l’événement, GUID est le GUID de l’événement. Consultez Événements d’appareil d’image fixe, et l’application spécifie l’application de création d’images à lancer lorsque l’événement se produit. Pour lancer l’application actuellement inscrite, utilisez un astérisque (*) pour App.		 facultatif.
Toutefois, cette entrée est requise pour la création d’applications Push-Model prenant en charge.
UninstallSection Pointe vers une section INF contenant généralement des directives INF DelFiles et des directives INF DelReg. Une entrée de cette section a le format suivant :

UninstallSection=UninstallSectionName

UninstallSectionName est le nom de la section contenant les directives Delfiles ou DelReg . La protection de fichiers Windows peut empêcher un utilisateur de supprimer certains fichiers, même s’ils sont spécifiés à l’aide de directives DelFiles .		 facultatif.
Cette entrée est valide uniquement pour Windows 2000.

Le programme d’installation de classe par défaut pour les appareils à image fixe prend en charge la directive INF CopyFiles standard. Le programme d’installation utilise un compteur de référence interne pour les fichiers de composants, de sorte que les fichiers partagés par plusieurs appareils ne sont pas supprimés prématurément pendant une opération de désinstallation.

Le fichier INF par défaut pour les appareils à image fixe, sti.inf, définit deux sections d’installation pour chaque type d’appareil, comme suit :

  • Une section INF DDInstall, qui doit être référencée dans la section DDInstall du fichier INF fourni par le fournisseur, comme indiqué dans le tableau suivant.

    Périphériques USB Appareils SCSI Appareils série
    Include=sti.inf

    Needs=STI.USBSection    		 Include=sti.inf

    Needs=STI.SCSISection    		 Include=sti.inf

    Needs=STI.SerialSection

  • Une section INF DDInstall.Services, qui doit être référencée dans DDInstall. Section Services du fichier INF fourni par le fournisseur, comme indiqué dans le tableau suivant.

    Périphériques USB Appareils SCSI Appareils série
    Include=sti.inf

    Needs=STI.USBSection.Services    		 Include=sti.inf

    Needs=STI.SCSISection.Services    		 Include=sti.inf

    Needs=STI.SerialSection.Services

Si vous créez également des composants spécifiques à l’appareil pour les API d’acquisition d’images, vous incluez généralement les noms de fichiers de ces composants dans le fichier INF.

Pour obtenir des conseils supplémentaires sur la création de fichiers INF pour les appareils à image fixe, vous pouvez consulter n’importe quel fichier INF fourni avec Windows qui contient l’entrée « Subclass=StillImage ».

Remarques

Lorsque vous développez un fichier INF pour les scanneurs, vous pouvez utiliser des descripteurs de système d’exploitation Microsoft pour activer la fonctionnalité d’ID de compatibilité. Dans ce cas, vous autorisez la compatibilité d’un pilote de scanneur avec plusieurs modèles de scanneur.