Partilhar via

Instalando componentes de controlador personalizados

Importante

A moderna plataforma de impressão é o meio preferido do Windows para comunicar com as impressoras. Recomendamos que utilize o controlador de classe da caixa de entrada IPP da Microsoft, juntamente com as Aplicações de Suporte de Impressão (PSA), 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 Guia de design do aplicativo de suporte de impressão v1 e v2.

Quando você fornece componentes personalizados para drivers de impressora da Microsoft, você também deve fornecer um arquivo de .ini para a instalação do componente. (Se a impressora não for suportada pelo 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.

onde n especifica a ordem em que 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. Com base 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, mais tarde, quando um driver precisa chamar funções de conexão DDI de gráficos e métodos COM fornecidos por esses plug-ins, xyzdrv1.dll é chamado antes xyzdrv2.dll.

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

Um arquivo .ini pode conter texto ANSI ou Unicode, mas o texto Unicode é recomendado. Dentro de 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 da impressora, uma maneira conveniente de instalar e registrar um componente personalizado é tornar o componente um arquivo dependente do driver da 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 da impressora.

Como alternativa, você pode instalar um componente personalizado tornando o componente um arquivo dependente para 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 da impressora, o componente deverá ser instalado no cliente de alguma forma diferente da operação de apontar e imprimir.

  • Last updated on