Partilhar via


Arquivos INF para dispositivos de imagem estática

The default class installer for still image devices, sti_ci.dll, recognizes a special set of INF file entries. Dentro de um arquivo INF, essas entradas devem ser colocadas dentro da seção INF DDInstall de um dispositivo. As entradas são descritas na tabela a seguir.

Entrada de arquivo INF Value Comments
SubClass StillImage Required
DeviceType 1 para scanners, 2 para câmaras, 3 para dispositivos de vídeo Required
DeviceSubType Vendor-defined value Optional
Connection Para dispositivos não-PnP conectados a portas seriais ou paralelas, isso pode ser Serial ou Parallel para limitar a escolha de portas do usuário durante a instalação. Optional.
Se não for especificado, o usuário pode selecionar qualquer porta serial ou paralela.
Capabilities Especifica um número que é convertido em sinalizadores de bits que identificam os recursos do dispositivo. These flags are stored in the registry and are available to Microsoft STI components with the STI_DEV_CAPS structure.

Bit 0 − Define / limpa STI_GENCAP_NOTIFICATIONS em STI_DEV_CAPS
Bit 1 − Define / limpa STI_GENCAP_POLLING_NEEDED em STI_DEV_CAPS
Bit 2 − Define / limpa STI_GENCAP_GENERATE_ARRIVALEVENT em STI_DEV_CAPS
Bit 3 − Define / limpa STI_GENCAP_AUTO_PORTSELECT em STI_DEV_CAPS
Optional
PropertyPages Identifica o nome e o ponto de entrada de uma DLL que cria páginas de folha de propriedades personalizadas para dispositivos de imagem estática.
The following example identifies the DLL, estp2cpl.dll, and the EnumStiPropPages entry point in this DLL. The entry point name is optional; if omitted, the entry point defaults to EnumStiPropPages.

PropertyPages = estp2cpl.dll, EnumStiPropPages

Optional
DeviceData Identifies a vendor-supplied data section containing information to be stored in the registry, under the DeviceData key. For TWAIN-supported devices, the data section must contain a TwainDS entry. Para obter mais informações, consulte Valores do Registro modificáveis pelo fornecedor Optional.
No entanto, essa entrada é necessária para criar aplicativos com reconhecimento de Push-Model.
Events Identifica uma seção de dados fornecida pelo fornecedor listando eventos de dispositivo de imagem estática. Cada entrada nesta secção deve ter o seguinte formato:

EventName="String",{GUID},App

EventName is the event's internal name, String is the event's display string, GUID is the event's GUID, see Still Image Device Events, and App specifies the imaging application to be launched when the event occurs. To launch the currently registered application, use an asterisk (*) for App.
Optional.
No entanto, essa entrada é necessária para criar aplicativos com reconhecimento de Push-Model.
UninstallSection Aponta para uma seção INF que normalmente contém diretivas INF DelFiles e diretivas INF DelReg. Uma entrada nesta seção tem o seguinte formato:

UninstallSection=UninstallSectionName

UninstallSectionName is the name of the section containing Delfiles or DelReg directives. A Proteção de Arquivos do Windows pode proibir um usuário de excluir alguns arquivos, mesmo que eles sejam especificados usando diretivas DelFiles .
Optional.
Esta entrada é válida apenas para o Windows 2000.

O instalador de classe padrão para dispositivos de imagem estática suporta a diretiva padrão INF CopyFiles. O instalador usa um contador de referência interno para arquivos de componentes, para que os arquivos compartilhados por vários dispositivos não sejam removidos prematuramente durante uma operação de desinstalação.

The default INF file for still image devices, sti.inf, defines two installation sections for each device type, as follows:

  • Uma seção INF DDInstall, que deve ser referenciada dentro da seção DDInstall do arquivo INF fornecido pelo fornecedor, conforme mostrado na tabela a seguir.

    USB devices SCSI devices Serial devices
    Include=sti.inf

    Needs=STI.USBSection
    Include=sti.inf

    Needs=STI.SCSISection
    Include=sti.inf

    Needs=STI.SerialSection
  • Uma seção INF DDInstall.Services, que deve ser referenciada dentro do DDInstall. Seção Serviços do arquivo INF fornecido pelo fornecedor, conforme mostrado na tabela a seguir.

    USB devices SCSI devices Serial devices
    Include=sti.inf

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

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

    Needs=STI.SerialSection.Services

Se você também estiver criando componentes específicos do dispositivo para APIs de aquisição de imagens, normalmente incluirá os nomes de arquivo para esses componentes no arquivo INF.

Para obter orientação adicional na criação de arquivos INF para dispositivos de imagem estática, você pode olhar para qualquer arquivo INF fornecido com o Windows que contém a entrada "Subclass=StillImage".

Remarks

Ao desenvolver um arquivo INF para scanners, você pode usar os descritores do sistema operacional Microsoft para habilitar a funcionalidade de ID de compatibilidade. Ao fazer isso, você permite que um driver de scanner seja compatível com vários modelos de scanner.