estrutura ATTRIBUTE_INFO_3 (winddiui.h)

Artigo
03/05/2024

A estrutura ATTRIBUTE_INFO_3 é usada como um parâmetro para a função DrvQueryJobAttributes de uma interface de impressora. Todos os valores de membro são fornecidos pela função.

Sintaxe

typedef struct _ATTRIBUTE_INFO_3 {
  DWORD dwJobNumberOfPagesPerSide;
  DWORD dwDrvNumberOfPagesPerSide;
  DWORD dwNupBorderFlags;
  DWORD dwJobPageOrderFlags;
  DWORD dwDrvPageOrderFlags;
  DWORD dwJobNumberOfCopies;
  DWORD dwDrvNumberOfCopies;
  DWORD dwColorOptimization;
  short dmPrintQuality;
  short dmYResolution;
} ATTRIBUTE_INFO_3, *PATTRIBUTE_INFO_3;

Membros

dwJobNumberOfPagesPerSide

Número de páginas de documento a serem colocadas em um lado de uma página física, conforme solicitado pelo usuário. Os valores permitidos são 1, 2, 4, 6, 9 ou 16.

dwDrvNumberOfPagesPerSide

Número de páginas de documentos que a impressora e o driver podem colocar em um lado de uma página física. Esse valor deve ser 1 ou o valor especificado para dwJobNumberOfPagesPerSide.

dwNupBorderFlags

Um dos seguintes valores de sinalizador de bit:

Sinalizador	Definição
BORDER_PRINT	O processador de impressão deve desenhar uma borda ao redor da página.
NO_BORDER_PRINT	O processador de impressão não deve desenhar uma borda ao redor da página.

dwJobPageOrderFlags

Um dos seguintes valores de sinalizador de bit:

Sinalizador	Definição
BOOKLET_PRINT	As páginas devem ser impressas no formato de livreto, com duas páginas de documento impressas em um lado de uma página física. No modo paisagem, as duas páginas de documento são impressas lado a lado no papel. No modo retrato, as duas páginas de documento são impressas na parte superior e inferior.
NORMAL_PRINT	As páginas devem ser impressas em ordem normal: página 1, página 2 e assim por diante.
REVERSE_PRINT	As páginas devem ser impressas em ordem inversa: última página, próxima à última página e assim por diante.

dwDrvPageOrderFlags

Sinalizadores de bits que indicam quais opções de ordenação de página têm suporte da impressora e do driver. Usa os mesmos sinalizadores que dwJobPageOrderFlags.

dwJobNumberOfCopies

Número de cópias do trabalho de impressão, conforme solicitado pelo usuário.

dwDrvNumberOfCopies

Número máximo de cópias que a impressora e o driver podem manipular de uma só vez, levando em conta atributos de trabalho como agrupamento e stapling.

dwColorOptimization

Um dos seguintes valores de sinalizador de bit:

Sinalizador	Definição
COLOR_OPTIMIZATION	O processador de impressão deve usar a otimização de cores monocromática.
NO_COLOR_OPTIMIZATION	O processador de impressão não deve usar a otimização de cores monocromática.

dmPrintQuality

Valor a ser usado em vez do membro dmPrintQuality da estrutura DEVMODEW do trabalho de impressão, se o sinalizador COLOR_OPTIMIZATION for definido em dwColorOptimization.

dmYResolution

Valor a ser usado em vez do membro dmYResolution da estrutura DEVMODEW do trabalho de impressão, se o sinalizador COLOR_OPTIMIZATION for definido em dwColorOptimization.

Comentários

Se o membro dmPrintQuality da estrutura DEVMODEW de um trabalho de impressão for um valor negativo, como DMRES_HIGH e se a otimização de cores monocromática estiver habilitada, alternar entre cor e monocromático poderá resultar em diferentes resoluções sendo usadas. Isso ocorre porque DMRES_HIGH pode ser atribuído a diferentes valores de DPI para renderização monocromática e de cor. (Para dispositivos com suporte unidrv, essa atribuição ocorre no arquivo GPD da impressora.) Para garantir uma resolução consistente em todo o trabalho de impressão, o driver pode especificar valores positivos dmPrintQuality e dmYResolution (representando uma resolução de DPI específica) para substituir os valores de DEVMODEW equivalentes.

O processador de impressão EMF usa o sinalizador especificado para dwColorOptimization para determinar se o GDI deve ser solicitado a executar a otimização de cores monocromática. Se a otimização de cores monocromática estiver habilitada, o trabalho de impressão poderá ser alternado entre a renderização monocromática e de cores, conforme apropriado.

Se você estiver criando um plug-in de renderização Unidrv para gerar marcas d'água coloridas, observe que quando o membro dwColorOptimization é definido como COLOR_OPTIMIZATION, as marcas d'água coloridas são impressas em preto e branco quando são impressas em documentos em preto e branco. Para garantir que as marcas d'água coloridas imprimam corretamente com documentos de cor e preto e branco, desabilite a otimização de cores. A otimização de cores também pode ser controlada pelo atributo de cor Unidrv *ChangeColorModeOnDoc? (consulte Atributos de Cor) e pela função GdiEndPageEMF .

Para obter informações sobre outros membros da estrutura ATTRIBUTE_INFO_3, consulte ATTRIBUTE_INFO_1 e ATTRIBUTE_INFO_2.