Compartilhar via


Atributos de comando

Important

A plataforma de impressão moderna é o meio preferido 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 o guia de design do Aplicativo de Suporte de Impressão v1 e v2.

Quando especificar um comando de impressora, use atributos para fornecer ao Unidrv as seguintes informações:

  • A sequência de escape que faz com que o hardware execute a operação, se a operação for implementada no hardware da impressora.

  • O identificador de retorno de chamada e os parâmetros exigidos pelo método IPrintOemUni::CommandCallback , se a operação for implementada em um plug-in de renderização.

  • A ordem na qual o comando deve ser enviado, em relação a outros comandos.

A tabela a seguir lista os atributos de comando em ordem alfabética e descreve os parâmetros.

Nome do atributo Parâmetro de atributo Comments
CallbackID Valor numérico positivo, passado para o método IPrintOemUni::CommandCallback do plug-in de renderização como seu argumento dCmdCbID . Necessário para comandos de impressora gerados dinamicamente. Não é válido se o Cmd for especificado.
Cmd Cadeia de caracteres de texto que contém uma sequência de escape de comando da impressora, especificada usando o formato de cadeia de caracteres de comando. Obrigatório, a menos que CallbackID seja especificado.
NoPageEject? TRUE ou FALSE, indicando se a execução do comando faz com que a impressora ejete a página física atual.

Usado somente se Order especificar a seção DOC_SETUP e se a impressão DUPLEX estiver habilitada. Para evitar a ejeção de página prematura entre páginas de documento duplexed, o Unidrv só emite comandos com esse atributo definido como TRUE, se possível.
Optional. Se não for especificado, o valor padrão será FALSE, o que significa que o comando pode causar ejeção de página.

Não deve ser TRUE se um comando causar efeitos colaterais (ou seja, se o comando modificar as configurações da impressora fora daquelas controladas por comandos com NoPageEject? definido como TRUE).
Order Nome da seção e número do pedido, conforme descrito em Ordem de execução do comando. Válido apenas com comandos de configuração e comandos de opção personalizados, a menos que indicado na descrição do comando.
Params Lista de variáveis padrão, passadas para o método IPrintOemUni::CommandCallback do plug-in de renderização na estrutura EXTRAPARAM que é passada como seu argumento pdwParams . Válido somente se CallbackID também for especificado.