Structure DEVMODEA (wingdi.h)
La structure de données DEVMODE contient des informations sur l’initialisation et l’environnement d’une imprimante ou d’un périphérique d’affichage.
Syntaxe
typedef struct _devicemodeA {
BYTE dmDeviceName[CCHDEVICENAME];
WORD dmSpecVersion;
WORD dmDriverVersion;
WORD dmSize;
WORD dmDriverExtra;
DWORD dmFields;
union {
struct {
short dmOrientation;
short dmPaperSize;
short dmPaperLength;
short dmPaperWidth;
short dmScale;
short dmCopies;
short dmDefaultSource;
short dmPrintQuality;
} DUMMYSTRUCTNAME;
POINTL dmPosition;
struct {
POINTL dmPosition;
DWORD dmDisplayOrientation;
DWORD dmDisplayFixedOutput;
} DUMMYSTRUCTNAME2;
} DUMMYUNIONNAME;
short dmColor;
short dmDuplex;
short dmYResolution;
short dmTTOption;
short dmCollate;
BYTE dmFormName[CCHFORMNAME];
WORD dmLogPixels;
DWORD dmBitsPerPel;
DWORD dmPelsWidth;
DWORD dmPelsHeight;
union {
DWORD dmDisplayFlags;
DWORD dmNup;
} DUMMYUNIONNAME2;
DWORD dmDisplayFrequency;
DWORD dmICMMethod;
DWORD dmICMIntent;
DWORD dmMediaType;
DWORD dmDitherType;
DWORD dmReserved1;
DWORD dmReserved2;
DWORD dmPanningWidth;
DWORD dmPanningHeight;
} DEVMODEA, *PDEVMODEA, *NPDEVMODEA, *LPDEVMODEA;
Membres
dmDeviceName[CCHDEVICENAME]
Tableau de caractères à terminaison zéro qui spécifie le nom « convivial » de l’imprimante ou de l’affichage ; par exemple, « PCL/HP LaserJet » dans le cas de PCL/HP LaserJet. Cette chaîne est unique parmi les pilotes de périphérique. Notez que ce nom peut être tronqué pour tenir dans le tableau dmDeviceName .
dmSpecVersion
Numéro de version de la spécification des données d’initialisation sur laquelle la structure est basée. Pour vous assurer que la version correcte est utilisée pour n’importe quel système d’exploitation, utilisez DM_SPECVERSION.
dmDriverVersion
Numéro de version du pilote attribué par le développeur du pilote.
dmSize
Spécifie la taille, en octets, de la structure DEVMODE , sans inclure les données spécifiques au pilote privé susceptibles de suivre les membres publics de la structure. Définissez ce membre sur sizeof (DEVMODE) pour indiquer la version de la structure DEVMODE utilisée.
dmDriverExtra
Contient le nombre d’octets de données de pilote privé qui suivent cette structure. Si un pilote de périphérique n’utilise pas d’informations spécifiques au périphérique, définissez ce membre sur zéro.
dmFields
Spécifie si certains membres de la structure DEVMODE ont été initialisés. Si un membre est initialisé, son bit correspondant est défini, sinon le bit est clair. Un pilote prend uniquement en charge les membres DEVMODE qui conviennent à la technologie d’imprimante ou d’affichage.
Les valeurs suivantes sont définies et sont répertoriées ici avec les membres de structure correspondants.
| Valeur | Membre de structure |
|---|---|
| DM_ORIENTATION | dmOrientation |
| DM_PAPERSIZE | dmPaperSize |
| DM_PAPERLENGTH | dmPaperLength |
| DM_PAPERWIDTH | dmPaperWidth |
| DM_SCALE | dmScale |
| DM_COPIES | dmCopies |
| DM_DEFAULTSOURCE | dmDefaultSource |
| DM_PRINTQUALITY | dmPrintQuality |
| DM_POSITION | dmPosition |
| DM_DISPLAYORIENTATION | dmDisplayOrientation |
| DM_DISPLAYFIXEDOUTPUT | dmDisplayFixedOutput |
| DM_COLOR | dmColor |
| DM_DUPLEX | dmDuplex |
| DM_YRESOLUTION | dmYResolution |
| DM_TTOPTION | dmTTOption |
| DM_COLLATE | dmCollate |
| DM_FORMNAME | dmFormName |
| DM_LOGPIXELS | dmLogPixels |
| DM_BITSPERPEL | dmBitsPerPel |
| DM_PELSWIDTH | dmPelsWidth |
| DM_PELSHEIGHT | dmPelsHeight |
| DM_DISPLAYFLAGS | dmDisplayFlags |
| DM_NUP | dmNup |
| DM_DISPLAYFREQUENCY | dmDisplayFrequency |
| DM_ICMMETHOD | dmICMMethod |
| DM_ICMINTENT | dmICMIntent |
| DM_MEDIATYPE | dmMediaType |
| DM_DITHERTYPE | dmDitherType |
| DM_PANNINGWIDTH | dmPanningWidth |
| DM_PANNINGHEIGHT | dmPanningHeight |
DUMMYUNIONNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmOrientation
Pour les imprimantes uniquement, sélectionne l’orientation du papier. Ce membre peut être DMORIENT_PORTRAIT (1) ou DMORIENT_LANDSCAPE (2).
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize
Pour les périphériques d’imprimante uniquement, sélectionne la taille du papier sur lequel imprimer. Ce membre peut être défini sur zéro si la longueur et la largeur du papier sont toutes deux définies par les membres dmPaperLength et dmPaperWidth . Sinon, le membre dmPaperSize peut être défini sur une valeur spécifique à l’appareil supérieure ou égale à DMPAPER_USER ou à l’une des valeurs prédéfinies suivantes.
| Valeur | Signification |
|---|---|
| DMPAPER_LETTER | Lettre, 8 1/2- par 11 pouces |
| DMPAPER_LEGAL | Juridique, 8 1/2- par 14 pouces |
| DMPAPER_9X11 | Feuille de 9 par 11 pouces |
| DMPAPER_10X11 | Feuille de 10 par 11 pouces |
| DMPAPER_10X14 | Feuille de 10 par 14 pouces |
| DMPAPER_15X11 | Feuille de 15 par 11 pouces |
| DMPAPER_11X17 | Feuille de 11 par 17 pouces |
| DMPAPER_12X11 | Feuille de 12 par 11 pouces |
| DMPAPER_A2 | Feuille A2, 420 x 594 millimètres |
| DMPAPER_A3 | Feuille A3, 297 par 420 millimètres |
| DMPAPER_A3_EXTRA | A3 Extra 322 x 445 millimètres |
| DMPAPER_A3_EXTRA_TRAVERSE | A3 Extra Transverse 322 x 445 millimètres |
| DMPAPER_A3_ROTATED | Feuille pivotée A3, 420 par 297 millimètres |
| DMPAPER_A3_TRAVERSE | A3 Transverse 297 x 420 millimètres |
| DMPAPER_A4 | Feuille A4, 210 par 297 millimètres |
| DMPAPER_A4_EXTRA | Feuille A4, 9,27 x 12,69 pouces |
| DMPAPER_A4_PLUS | A4 Plus 210 x 330 millimètres |
| DMPAPER_A4_ROTATED | Feuille pivotée A4, 297- par 210 millimètres |
| DMPAPER_A4SMALL | Petite feuille A4, 210- par 297-millimètres |
| DMPAPER_A4_TRANSVERSE | A4 Transverse 210 x 297 millimètres |
| DMPAPER_A5 | Feuille A5, 148 sur 210 millimètres |
| DMPAPER_A5_EXTRA | A5 Extra 174 x 235 millimètres |
| DMPAPER_A5_ROTATED | Feuille pivotée A5, 210 par 148 millimètres |
| DMPAPER_A5_TRANSVERSE | A5 Transverse 148 x 210 millimètres |
| DMPAPER_A6 | Feuille A6, 105 par 148 millimètres |
| DMPAPER_A6_ROTATED | Feuille pivotée A6, 148- par 105 millimètres |
| DMPAPER_A_PLUS | SuperA/A4 227 x 356 millimètres |
| DMPAPER_B4 | Feuille B4, 250 par 354 millimètres |
| DMPAPER_B4_JIS_ROTATED | Feuille pivotée B4 (JIS), 364 par 257 millimètres |
| DMPAPER_B5 | Feuille B5, papier 182 par 257 millimètres |
| DMPAPER_B5_EXTRA | B5 (ISO) Extra 201 x 276 millimètres |
| DMPAPER_B5_JIS_ROTATED | Feuille pivotée B5 (JIS), 257- par 182-millimètres |
| DMPAPER_B6_JIS | Feuille B6 (JIS), 128 par 182 millimètres |
| DMPAPER_B6_JIS_ROTATED | Feuille pivotée B6 (JIS), 182- par 128 millimètres |
| DMPAPER_B_PLUS | SuperB/A3 305 x 487 millimètres |
| DMPAPER_CSHEET | Feuille C, 17 par 22 pouces |
| DMPAPER_DBL_JAPANESE_POSTCARD | Carte postale japonaise double, 200- par 148 millimètres |
| DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED | Carte postale japonaise double rotative, 148- par 200 millimètres |
| DMPAPER_DSHEET | Feuille D, 22 x 34 pouces |
| DMPAPER_ENV_9 | #9 Enveloppe, 3 7/8- par 8 7/8 pouces |
| DMPAPER_ENV_10 | #10 Enveloppe, 4 1/8- par 9 1/2 pouces |
| DMPAPER_ENV_11 | #11 Enveloppe, 4 1/2- par 10 3/8 pouces |
| DMPAPER_ENV_12 | Enveloppe #12, 4 3/4- par 11 pouces |
| DMPAPER_ENV_14 | Enveloppe #14, 5 par 11 1/2 pouces |
| DMPAPER_ENV_C5 | Enveloppe C5, 162 par 229 millimètres |
| DMPAPER_ENV_C3 | Enveloppe C3, 324 sur 458 millimètres |
| DMPAPER_ENV_C4 | Enveloppe C4, 229 par 324 millimètres |
| DMPAPER_ENV_C6 | Enveloppe C6, 114 sur 162 millimètres |
| DMPAPER_ENV_C65 | Enveloppe C65, 114 par 229 millimètres |
| DMPAPER_ENV_B4 | Enveloppe B4, 250 par 353 millimètres |
| DMPAPER_ENV_B5 | Enveloppe B5, 176 par 250 millimètres |
| DMPAPER_ENV_B6 | Enveloppe B6, 176 par 125 millimètres |
| DMPAPER_ENV_DL | Enveloppe DL, 110 par 220 millimètres |
| DMPAPER_ENV_INVITE | Enveloppe Invitation 220 x 220 mm |
| DMPAPER_ENV_ITALY | Enveloppe Italie, 110- par 230-millimètres |
| DMPAPER_ENV_MONARCH | Enveloppe monarch, 3 7/8- par 7 1/2 pouces |
| DMPAPER_ENV_PERSONAL | Enveloppe 6 3/4, 3 5/8- par 6 1/2 pouces |
| DMPAPER_ESHEET | Feuille E, 34 x 44 pouces |
| DMPAPER_EXECUTIVE | Exécutif, 7 1/4- par 10 1/2 pouces |
| DMPAPER_FANFOLD_US | US Std Fanfold, 14 7/8- par 11 pouces |
| DMPAPER_FANFOLD_STD_GERMAN | Std Fanfold allemand, 8 1/2- par 12 pouces |
| DMPAPER_FANFOLD_LGL_GERMAN | Fanfold juridique allemand, 8 - par 13 pouces |
| DMPAPER_FOLIO | Folio, papier 8 1/2- par 13 pouces |
| DMPAPER_ISO_B4 | Papier B4 (ISO) 250 par 353 millimètres |
| DMPAPER_JAPANESE_POSTCARD | Carte postale japonaise, 100 par 148 millimètres |
| DMPAPER_JAPANESE_POSTCARD_ROTATED | Carte postale japonaise rotative, 148- par 100 millimètres |
| DMPAPER_JENV_CHOU3 | Enveloppe japonaise Chou #3 |
| DMPAPER_JENV_CHOU3_ROTATED | Enveloppe japonaise Chou #3 Pivotée |
| DMPAPER_JENV_CHOU4 | Enveloppe japonaise Chou #4 |
| DMPAPER_JENV_CHOU4_ROTATED | Enveloppe japonaise Chou #4 Pivotée |
| DMPAPER_JENV_KAKU2 | Enveloppe japonaise Kaku #2 |
| DMPAPER_JENV_KAKU2_ROTATED | Enveloppe japonaise Kaku #2 Pivotée |
| DMPAPER_JENV_KAKU3 | Enveloppe japonaise Kaku #3 |
| DMPAPER_JENV_KAKU3_ROTATED | Enveloppe japonaise Kaku #3 Pivotée |
| DMPAPER_JENV_YOU4 | Enveloppe japonaise vous #4 |
| DMPAPER_JENV_YOU4_ROTATED | Enveloppe japonaise vous #4 Pivoté |
| DMPAPER_LAST | DMPAPER_PENV_10_ROTATED |
| DMPAPER_LEDGER | Registre, 17 par 11 pouces |
| DMPAPER_LEGAL_EXTRA | Legal Extra 9 1/2 x 15 pouces. |
| DMPAPER_LETTER_EXTRA | LETTRE Extra 9 1/2 x 12 pouces. |
| DMPAPER_LETTER_EXTRA_TRANSVERSE | LETTRE Extra Transverse 9 1/2 x 12 pouces. |
| DMPAPER_LETTER_ROTATED | LETTRE PIVOTÉE 11 par 8 1/2 pouces |
| DMPAPER_LETTERSMALL | LETTRE PETITE, 8 1/2- par 11 pouces |
| DMPAPER_LETTER_TRANSVERSE | LETTRE TRANSVERSE 8 1/2 x 11 pouces |
| DMPAPER_NOTE | Remarque, 8 1/2- par 11 pouces |
| DMPAPER_P16K | PRC 16K, 146- par 215 millimètres |
| DMPAPER_P16K_ROTATED | PRC 16K pivoté, 215- par 146-millimètres |
| DMPAPER_P32K | PRC 32K, 97- par 151-millimètres |
| DMPAPER_P32K_ROTATED | PRC 32K pivoté, 151- par 97 millimètres |
| DMPAPER_P32KBIG | PRC 32K(Big) 97- by 151-millimètres |
| DMPAPER_P32KBIG_ROTATED | PRC 32K (Big) rotated, 151- par 97-millimètres |
| DMPAPER_PENV_1 | Enveloppe PRC n° 1, 102- par 165 millimètres |
| DMPAPER_PENV_1_ROTATED | Enveloppe prc #1 pivotée, 165- par 102 millimètres |
| DMPAPER_PENV_2 | Enveloppe PRC #2, 102- par 176 millimètres |
| DMPAPER_PENV_2_ROTATED | Enveloppe prc #2 pivotée, 176- par 102 millimètres |
| DMPAPER_PENV_3 | Enveloppe PRC n°3, 125- par 176 millimètres |
| DMPAPER_PENV_3_ROTATED | Enveloppe prc #3 pivotée, 176- par 125 millimètres |
| DMPAPER_PENV_4 | Enveloppe PRC n°4, 110- par 208 millimètres |
| DMPAPER_PENV_4_ROTATED | Enveloppe PRC #4 pivotée, 208- par 110 millimètres |
| DMPAPER_PENV_5 | Enveloppe PRC n°5, 110- par 220 millimètres |
| DMPAPER_PENV_5_ROTATED | Enveloppe PRC #5 pivotée, 220- par 110-millimètres |
| DMPAPER_PENV_6 | Enveloppe PRC n°6, 120- par 230 millimètres |
| DMPAPER_PENV_6_ROTATED | Enveloppe PRC #6 Pivotée, 230- par 120 millimètres |
| DMPAPER_PENV_7 | Enveloppe prc #7, 160- par 230 millimètres |
| DMPAPER_PENV_7_ROTATED | Enveloppe PRC #7 pivotée, 230- par 160 millimètres |
| DMPAPER_PENV_8 | Enveloppe PRC n°8, 120- par 309 millimètres |
| DMPAPER_PENV_8_ROTATED | Enveloppe prc #8 pivotée, 309- par 120 millimètres |
| DMPAPER_PENV_9 | Enveloppe PRC n°9, 229- par 324 millimètres |
| DMPAPER_PENV_9_ROTATED | Enveloppe prc #9 pivotée, 324- par 229-millimètres |
| DMPAPER_PENV_10 | Enveloppe PRC #10, 324- par 458 millimètres |
| DMPAPER_PENV_10_ROTATED | Enveloppe prc #10 pivotée, 458- par 324-millimètres |
| DMPAPER_QUARTO | Quarto, papier 215 par 275 millimètres |
| DMPAPER_STATEMENT | Instruction, 5 1/2- par 8 1/2 pouces |
| DMPAPER_TABLOID | Tabloïd, 11 par 17 pouces |
| DMPAPER_TABLOID_EXTRA | Tabloïd, 11,69 x 18 pouces |
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength
Pour les périphériques d’imprimante uniquement, remplace la longueur du papier spécifiée par le membre dmPaperSize , soit pour les formats de papier personnalisés, soit pour les appareils tels que les imprimantes à matrice de points qui peuvent imprimer sur une page de longueur arbitraire. Ces valeurs, ainsi que toutes les autres valeurs de cette structure qui spécifient une longueur physique, sont en dixièmes de millimètre.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth
Pour les périphériques d’imprimante uniquement, remplace la largeur du papier spécifié par le membre dmPaperSize .
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale
Spécifie le facteur selon lequel la sortie imprimée doit être mise à l’échelle. La taille de page apparente est mise à l’échelle à partir de la taille de la page physique par un facteur dmScale /100. Par exemple, une page de taille lettre avec une valeur dmScale de 50 contiendrait autant de données qu’une page de 17 par 22 pouces, car le texte et les graphiques de sortie seraient deux fois moins hauts que la largeur d’origine.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies
Sélectionne le nombre de copies imprimées si l’appareil prend en charge les copies sur plusieurs pages.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource
Spécifie la source de papier. Pour récupérer la liste des sources de papier disponibles pour une imprimante, utilisez la fonction DeviceCapabilities avec l’indicateur DC_BINS.
Ce membre peut être l’une des valeurs suivantes, ou il peut s’agir d’une valeur spécifique à l’appareil supérieure ou égale à DMBIN_USER.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality
Spécifie la résolution de l’imprimante. Il existe quatre valeurs prédéfinies indépendantes de l’appareil :
Si une valeur positive est spécifiée, elle spécifie le nombre de points par pouce (PPP) et dépend donc de l’appareil.
DUMMYUNIONNAME.dmPosition
DUMMYUNIONNAME.DUMMYSTRUCTNAME2
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition
Pour les appareils d’affichage uniquement, structure POINTL qui indique les coordonnées positionnelles de l’appareil d’affichage en référence à la zone de bureau. Le périphérique d’affichage principal se trouve toujours aux coordonnées (0,0).
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation
Pour les appareils d’affichage uniquement, orientation à laquelle les images doivent être présentées. Si DM_DISPLAYORIENTATION n’est pas défini, ce membre doit être égal à zéro. Si DM_DISPLAYORIENTATION est défini, ce membre doit être l’une des valeurs suivantes
| Valeur | Signification |
|---|---|
| DMDO_DEFAULT | L’orientation de l’affichage est l’orientation naturelle de l’appareil d’affichage ; il doit être utilisé comme valeur par défaut. |
| DMDO_90 | L’orientation de l’affichage est pivotée de 90 degrés (mesurée dans le sens des aiguilles d’une montre) à partir de DMDO_DEFAULT. |
| DMDO_180 | L’orientation de l’affichage est pivotée de 180 degrés (mesurée dans le sens des aiguilles d’une montre) à partir de DMDO_DEFAULT. |
| DMDO_270 | L’orientation de l’affichage est pivotée de 270 degrés (mesurée dans le sens des aiguilles d’une montre) à partir de DMDO_DEFAULT. |
Pour déterminer si l’orientation de l’affichage est portrait ou paysage, case activée le rapport dmPelsWidth surdmPelsHeight.
Windows 2000 : Non pris en charge.
DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput
Pour les appareils d’affichage à résolution fixe uniquement, comment l’affichage présente un mode basse résolution sur un écran à résolution plus élevée. Par exemple, si la résolution d’un périphérique d’affichage est fixée à 1024 x 768 pixels, mais que son mode est défini sur 640 x 480 pixels, l’appareil peut afficher une image de 640 x 480 quelque part à l’intérieur de l’espace d’écran 1024 x 768 ou étirer l’image de 640 x 480 pour remplir l’espace d’écran plus grand. Si DM_DISPLAYFIXEDOUTPUT n’est pas défini, ce membre doit être égal à zéro. Si DM_DISPLAYFIXEDOUTPUT est défini, ce membre doit être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| DMDFO_DEFAULT | Paramètre par défaut de l’affichage. |
| DMDFO_CENTER | L’image basse résolution est centrée dans l’espace d’écran plus grand. |
| DMDFO_STRETCH | L’image basse résolution est étirée pour remplir l’espace d’écran plus grand. |
Windows 2000 : Non pris en charge.
dmColor
Bascule entre la couleur et le monochrome sur les imprimantes couleur. Les valeurs possibles sont les suivantes :
- DMCOLOR_COLOR
- DMCOLOR_MONOCHROME
dmDuplex
Sélectionne l’impression recto-verso ou recto-verso pour les imprimantes capables d’impression recto verso. Voici les valeurs possibles.
| Valeur | Signification |
|---|---|
| DMDUP_SIMPLEX | Impression normale (nonduplexe). |
| DMDUP_HORIZONTAL | Liaison à bord court, autrement dit, le bord long de la page est horizontal. |
| DMDUP_VERTICAL | Liaison à bord long, autrement dit, le bord long de la page est vertical. |
dmYResolution
Spécifie la résolution y, en points par pouce, de l’imprimante. Si l’imprimante initialise ce membre, le membre dmPrintQuality spécifie la résolution x, en points par pouce, de l’imprimante.
dmTTOption
Spécifie la façon dont les polices TrueType doivent être imprimées. Ce membre peut être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| DMTT_BITMAP | Imprime les polices TrueType sous forme de graphiques. Il s’agit de l’action par défaut pour les imprimantes à matrice de points. |
| DMTT_DOWNLOAD | Télécharge les polices TrueType en tant que polices logicielles. Il s’agit de l’action par défaut pour Hewlett-Packard imprimantes qui utilisent le langage de contrôle d’imprimante (PCL). |
| DMTT_DOWNLOAD_OUTLINE | Télécharge les polices TrueType en tant que polices logicielles de contour. |
| DMTT_SUBDEV | Remplace les polices d’appareil par les polices TrueType. Il s’agit de l’action par défaut pour les imprimantes PostScript. |
dmCollate
Spécifie si le classement doit être utilisé lors de l’impression de plusieurs copies. (Ce membre est ignoré, sauf si le pilote d’imprimante indique la prise en charge du classement en définissant le membre dmFields sur DM_COLLATE.) Ce membre peut être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| DMCOLLATE_TRUE | Collez lors de l’impression de plusieurs copies. |
| DMCOLLATE_FALSE | Ne collez pas lors de l’impression de plusieurs copies. |
dmFormName[CCHFORMNAME]
Tableau de caractères sans fin qui spécifie le nom du formulaire à utiliser ; par exemple, « Letter » ou « Legal ». Un ensemble complet de noms peut être récupéré à l’aide de la fonction EnumForms .
dmLogPixels
Nombre de pixels par pouce logique. Les pilotes d’imprimante n’utilisent pas ce membre.
dmBitsPerPel
Spécifie la résolution des couleurs, en bits par pixel, de l’appareil d’affichage (par exemple : 4 bits pour 16 couleurs, 8 bits pour 256 couleurs ou 16 bits pour 65 536 couleurs). Les pilotes d’affichage utilisent ce membre, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.
dmPelsWidth
Spécifie la largeur, en pixels, de la surface visible de l’appareil. Les pilotes d’affichage utilisent ce membre, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.
dmPelsHeight
Spécifie la hauteur, en pixels, de la surface visible de l’appareil. Les pilotes d’affichage utilisent ce membre, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.dmDisplayFlags
Spécifie le mode d’affichage de l’appareil. Ce membre peut être une combinaison des valeurs suivantes.
| Valeur | Signification |
|---|---|
| DM_GRAYSCALE | Spécifie que l’affichage est un appareil non coloré. Si cet indicateur n’est pas défini, la couleur est supposée. Cet indicateur n’est plus valide. |
| DM_INTERLACED | Spécifie que le mode d’affichage est entrelacé. Si l’indicateur n’est pas défini, non entrelacé est supposé. |
Les pilotes d’affichage utilisent ce membre, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.
DUMMYUNIONNAME2.dmNup
Spécifie l’emplacement où le NUP est effectué. Il peut s’agir de l’un des éléments suivants.
| Valeur | Signification |
|---|---|
| DMNUP_SYSTEM | Le spouleur d’impression effectue le NUP. |
| DMNUP_ONEUP | L’application effectue le NUP. |
dmDisplayFrequency
Spécifie la fréquence, en hertz (cycles par seconde), de l’appareil d’affichage dans un mode particulier. Cette valeur est également appelée taux d’actualisation verticale de l’appareil d’affichage. Les pilotes d’affichage utilisent ce membre. Il est utilisé, par exemple, dans la fonction ChangeDisplaySettings . Les pilotes d’imprimante n’utilisent pas ce membre.
Lorsque vous appelez la fonction EnumDisplaySettings , le membre dmDisplayFrequency peut retourner la valeur 0 ou 1. Ces valeurs représentent le taux d’actualisation par défaut du matériel d’affichage. Ce taux par défaut est généralement défini par des commutateurs sur un écran carte ou une carte mère d’ordinateur, ou par un programme de configuration qui n’utilise pas de fonctions d’affichage telles que ChangeDisplaySettings.
dmICMMethod
Spécifie la façon dont ICM est géré. Pour une application non ICM, ce membre détermine si ICM est activé ou désactivé. Pour les applications ICM, le système examine ce membre pour déterminer comment gérer la prise en charge ICM. Ce membre peut être l’une des valeurs prédéfinies suivantes ou une valeur définie par le pilote supérieure ou égale à la valeur de DMICMMETHOD_USER.
| Valeur | Signification |
|---|---|
| DMICMMETHOD_NONE | Spécifie qu’ICM est désactivé. |
| DMICMMETHOD_SYSTEM | Spécifie qu’ICM est géré par Windows. |
| DMICMMETHOD_DRIVER | Spécifie que ICM est géré par le pilote de périphérique. |
| DMICMMETHOD_DEVICE | Spécifie que L’ICM est géré par l’appareil de destination. |
Le pilote d’imprimante doit fournir une interface utilisateur pour définir ce membre. La plupart des pilotes d’imprimante prennent uniquement en charge la valeur DMICMMETHOD_SYSTEM ou DMICMMETHOD_NONE. Les pilotes pour les imprimantes PostScript prennent en charge toutes les valeurs.
dmICMIntent
Spécifie la méthode de correspondance de couleur, ou l’intention, qui doit être utilisée par défaut. Ce membre est principalement destiné aux applications non-ICM. Les applications ICM peuvent établir des intentions à l’aide des fonctions ICM. Ce membre peut être l’une des valeurs prédéfinies suivantes ou une valeur définie par le pilote supérieure ou égale à la valeur de DMICM_USER.
| Valeur | Signification |
|---|---|
| DMICM_ABS_COLORIMETRIC | La correspondance des couleurs doit être optimisée pour correspondre exactement à la couleur demandée sans mappage de points blancs. Cette valeur est la plus appropriée pour une utilisation avec la vérification linguistique. |
| DMICM_COLORIMETRIC | La correspondance des couleurs doit être optimisée pour correspondre à la couleur exacte demandée. Cette valeur est la plus appropriée pour une utilisation avec des logos d’entreprise ou d’autres images lorsqu’une correspondance de couleur exacte est souhaitée. |
| DMICM_CONTRAST | La correspondance des couleurs doit être optimisée pour le contraste des couleurs. Cette valeur est le choix le plus approprié pour les images numérisées ou photographiques lorsque le dithering est souhaité. |
| DMICM_SATURATE | La correspondance des couleurs doit être optimisée pour la saturation des couleurs. Cette valeur est le choix le plus approprié pour les graphiques d’entreprise lorsque le tramage n’est pas souhaité. |
dmMediaType
Spécifie le type de média en cours d’impression. Le membre peut être l’une des valeurs prédéfinies suivantes ou une valeur définie par le pilote supérieure ou égale à la valeur de DMMEDIA_USER.
| Valeur | Signification |
|---|---|
| DMMEDIA_STANDARD | Papier ordinaire. |
| DMMEDIA_GLOSSY | Papier glacé. |
| DMMEDIA_TRANSPARENCY | Film transparent. |
Pour récupérer la liste des types de supports disponibles pour une imprimante, utilisez la fonction DeviceCapabilities avec l’indicateur DC_MEDIATYPES.
dmDitherType
Spécifie la façon dont le dithering doit être effectué. Le membre peut être l’une des valeurs prédéfinies suivantes, ou une valeur définie par le pilote supérieure ou égale à la valeur de DMDITHER_USER.
| Valeur | Signification |
|---|---|
| DMDITHER_NONE | Pas de tergiversation. |
| DMDITHER_COARSE | Dithering avec un pinceau grosseur. |
| DMDITHER_FINE | Tergiversation avec un pinceau fin. |
| DMDITHER_LINEART | Trames d’illustration de trait, une méthode de tramage spéciale qui produit des bordures bien définies entre la mise à l’échelle en noir, blanc et gris. Il ne convient pas aux images qui incluent des graduations continues en intensité et en teinte, telles que les photographies numérisées. |
| DMDITHER_GRAYSCALE | L’appareil effectue une mise à l’échelle en gris. |
dmReserved1
Non utilisé ; doit être égal à zéro.
dmReserved2
Non utilisé ; doit être égal à zéro.
dmPanningWidth
Ce membre doit être égal à zéro.
dmPanningHeight
Ce membre doit être égal à zéro.
Remarques
Les données privées d’un pilote de périphérique suivent la partie publique de la structure DEVMODE . La taille des données publiques peut varier selon les versions de la structure. Le membre dmSize spécifie le nombre d’octets de données publiques, et le membre dmDriverExtra spécifie le nombre d’octets de données privées.
Notes
L’en-tête wingdi.h définit DEVMODE en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | wingdi.h (inclure Windows.h) |