Atributos de comando

Importante

Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft, juntamente com o PSA (Aplicativos de Suporte para Impressão), para personalizar a experiência de impressão em 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 para impressão.

Ao especificar um comando de impressora, você usa 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 seus parâmetros.

Nome do atributo	Parâmetro de atributos	Comentários
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 Cmd for especificado.
Cmd	Cadeia de caracteres de texto que contém uma sequência de escape de comando de 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 prematura de páginas entre páginas de documento duplexadas, o Unidrv só emite 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 da ordem, conforme descrito em Ordem de Execução de Comando.	Válido somente 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 passada como seu argumento pdwParams .	Válido somente se CallbackID também for especificado.

Para obter exemplos, consulte os arquivos GPD de exemplo.