Instalando componentes de driver personalizados

Importante

A plataforma de impressão moderna é o meio preferencial do Windows para se comunicar com as impressoras. Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft juntamente com PSA (Aplicativos de Suporte à Impressão) para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.

Para obter mais informações, consulte Plataformade impressão moderna e o Guia de design do aplicativo de suporte de impressão.

Ao fornecer componentes personalizados para os drivers de impressora da Microsoft, você também deve fornecer um arquivo .ini para a instalação do componente. (Se a impressora não for compatível com ntprint.inf, você também deverá fornecer um arquivo INF da impressora.)

O arquivo .ini deve conter uma seção OEMFiles. Nesta seção, cada componente personalizado é descrito usando uma das seguintes entradas:

• OEMDriverFilen

  Nomeia um plug-in de renderização.

• OEMConfigFilen

  Nomeia um plug-in de interface do usuário.

em que n especifica a ordem na qual o instalador instala os arquivos. Os números especificados para n devem ser contíguos, começando com 1, para ambos os tipos de plug-ins.

Por exemplo, se você estiver fornecendo dois plug-ins de renderização e um plug-in de interface do usuário e o modelo da impressora for XYZ, o arquivo .ini poderá aparecer da seguinte maneira:

[OEMFiles]
OEMDriverFile1=XYZDRV1.DLL
OEMConfigFile1=XYZUI1.DLL
OEMDriverFile2=XYZDRV2.DLL

Não são permitidos espaços antes ou depois do sinal de igual (=). Os nomes de arquivo não podem incluir especificações de caminho.

No exemplo, dois plug-ins de renderização são especificados. Baseado nos valores n para OEMDriverFilen, xyzdrv1.dll é instalado antes xyzdrv2.dll. Os drivers Unidrv e Pscript5 chamam plug-ins na ordem em que são instalados, portanto, posteriormente, quando um driver precisar chamar funções de conexão DDI de gráficos e métodos COM fornecidos por esses plug-ins, xyzdrv1.dll será chamado antes xyzdrv2.dll.

O nome do arquivo .ini deve refletir o nome do produto da impressora. O nome do arquivo .ini deve ser distinto dos nomes dos arquivos .ini de outras impressoras para evitar conflitos de nome. Se você estiver portando um plug-in de renderização ou plug-in de interface do usuário para Windows NT 4.0, o nome do arquivo .ini deverá corresponder ao nome do arquivo .gpd ou .ppd. (Ou seja, xyz.ini deve ser usado para xyz.gpd ou xyz.ppd.) Essa restrição não se aplica ao Windows 2000 ou versões posteriores do sistema operacional Windows.

Um arquivo .ini pode conter texto ANSI ou Unicode, mas o texto Unicode é recomendado. Em um arquivo .ini, as linhas que começam com o sinal de libra (#) são comentários.

Para obter mais informações, consulte Diretrizes gerais para arquivos INF e Instalando um minidriver Unidrv.

Se você fornecer um arquivo INF de impressora, uma maneira conveniente de instalar e registrar um componente personalizado é tornar o componente um arquivo dependente do driver de impressora. Além disso, o arquivo .inf associado pode ser instalado como um arquivo dependente. Para obter mais informações sobre arquivos dependentes para drivers de impressora, consulte Entradas de arquivo INF de impressora.

Como alternativa, você pode instalar um componente personalizado tornando-o um arquivo dependente de outro componente de impressão, como um monitor de porta ou um aplicativo de status. No entanto, esse método pode criar dificuldades porque as operações de apontar e imprimir instalam apenas o driver e os arquivos dependentes do driver no cliente. Se um componente personalizado não estiver listado como um arquivo dependente do driver de impressora, o componente deverá ser instalado no cliente de alguma forma diferente da operação de apontar e imprimir.