Partilhar via


Atributos de comando

Importante

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 Plataformade impressão moderna e o Guia de design do aplicativo de suporte de impressão.

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 plugin 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 atributos Comentários
CallbackID Valor numérico positivo, passado para o método IPrintOemUni::CommandCallback do plugin de renderização como seu argumento dCmdCbID. Necessário para comandos de impressora gerados dinamicamente. Não é válido se 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 Ordem especificar a seção DOC_SETUP e se a impressão DUPLEX estiver ativada. Para evitar a ejeção prematura de páginas entre páginas de documentos duplex, o Unidrv emite apenas comandos com esse atributo definido como TRUE, se possível.
Opcional. 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).
Ordem 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.
Parâmetros Lista de variáveis padrão, passadas para o método IPrintOemUni::CommandCallback do plugin de renderização na estrutura EXTRAPARAM que é passada como seu argumento pdwParams. Válido somente se CallbackID também for especificado.