structure ATTRIBUTE_INFO_3 (winsplp.h)

Article
02/27/2024

La structure ATTRIBUTE_INFO_3 est utilisée comme paramètre pour la fonction DrvQueryJobAttributes d’une DLL d’imprimante. Toutes les valeurs membres sont fournies par fonction.

Syntaxe

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;

Membres

dwJobNumberOfPagesPerSide

Nombre de pages de document à placer sur un côté d’une page physique, comme demandé par l’utilisateur. Les valeurs autorisées sont 1, 2, 4, 6, 9 ou 16.

dwDrvNumberOfPagesPerSide

Nombre de pages de document que l’imprimante et le pilote peuvent placer sur un côté d’une page physique. Cette valeur doit être 1 ou la valeur spécifiée pour dwJobNumberOfPagesPerSide.

dwNupBorderFlags

Une des valeurs d’indicateur de bits suivantes :

Indicateur	Définition
BORDER_PRINT	Le processeur d’impression doit dessiner une bordure autour de la page.
NO_BORDER_PRINT	Le processeur d’impression ne doit pas dessiner de bordure autour de la page.

dwJobPageOrderFlags

Une des valeurs d’indicateur de bits suivantes :

Indicateur	Définition
BOOKLET_PRINT	Les pages doivent être imprimées sous forme de livret, avec deux pages de document imprimées sur un côté d’une page physique. En mode paysage, les deux pages de document sont imprimées côte à côte sur le papier. En mode portrait, les deux pages de document sont imprimées en haut et en bas.
NORMAL_PRINT	Les pages doivent être imprimées dans l’ordre normal : page 1, page 2, etc.
REVERSE_PRINT	Les pages doivent être imprimées dans l’ordre inverse : dernière page, avant-dernière page, etc.

dwDrvPageOrderFlags

Indicateurs de bits indiquant les options de classement des pages prises en charge par l’imprimante et le pilote. Utilise les mêmes indicateurs que dwJobPageOrderFlags.

dwJobNumberOfCopies

Nombre de copies du travail d’impression, comme demandé par l’utilisateur.

dwDrvNumberOfCopies

Nombre maximal de copies que l’imprimante et le pilote peuvent gérer à la fois, en tenant compte des attributs de travail tels que le regroupement et l’agrafage.

dwColorOptimization

Une des valeurs d’indicateur de bits suivantes :

Indicateur	Définition
COLOR_OPTIMIZATION	Le processeur d’impression doit utiliser l’optimisation des couleurs monochromes.
NO_COLOR_OPTIMIZATION	Le processeur d’impression ne doit pas utiliser l’optimisation des couleurs monochromes.

dmPrintQuality

Valeur à utiliser au lieu du membre dmPrintQuality de la structure DEVMODEW du travail d’impression, si l’indicateur COLOR_OPTIMIZATION est défini dans dwColorOptimization.

dmYResolution

Valeur à utiliser au lieu du membre dmYResolution de la structure DEVMODEW du travail d’impression, si l’indicateur COLOR_OPTIMIZATION est défini dans dwColorOptimization.

Remarques

Si le membre dmPrintQuality de la structure DEVMODEW d’un travail d’impression est une valeur négative, telle que DMRES_HIGH, et si l’optimisation des couleurs monochromes est activée, le basculement entre la couleur et le monochrome peut entraîner l’utilisation de différentes résolutions. Cela est dû au fait que DMRES_HIGH peut être affecté à différentes valeurs DPI pour le rendu couleur et monochrome. (Pour les appareils pris en charge par Unidrv, cette affectation se produit dans le fichier GPD de l’imprimante.) Pour garantir une résolution cohérente tout au long de la tâche d’impression, le pilote peut spécifier des valeurs dmPrintQuality et dmYResolution positives (représentant une résolution DPI spécifique) pour remplacer les valeurs DEVMODEW équivalentes.

Le processeur d’impression EMF utilise l’indicateur spécifié pour dwColorOptimization pour déterminer s’il faut demander à GDI d’effectuer une optimisation des couleurs monochromes. Si l’optimisation des couleurs monochromes est activée, la tâche d’impression peut basculer entre le rendu monochrome et le rendu des couleurs le cas échéant.

Si vous créez un plug-in de rendu Unidrv pour générer des filigranes de couleur, notez que lorsque le membre dwColorOptimization est défini sur COLOR_OPTIMIZATION, les filigranes de couleur sont imprimés en noir et blanc lorsqu’ils sont imprimés sur des documents en noir et blanc. Pour vous assurer que les filigranes de couleur s’impriment correctement avec des documents en couleur et en noir et blanc, désactivez l’optimisation des couleurs. L’optimisation des couleurs peut également être contrôlée par l’attribut de couleur Unidrv *ChangeColorModeOnDoc ? (voir Attributs de couleur) et par la fonction GdiEndPageEMF .

Pour plus d’informations sur les autres membres de la structure ATTRIBUTE_INFO_3, consultez ATTRIBUTE_INFO_1 et ATTRIBUTE_INFO_2.