typedef struct _DEVMODEW {
WCHAR dmDeviceName[CCHDEVICENAME];
WORD dmSpecVersion;
WORD dmDriverVersion;
WORD dmSize;
WORD dmDriverExtra;
DWORD dmFields;
short dmOrientation;
short dmPaperSize;
short dmPaperLength;
short dmPaperWidth;
short dmScale;
short dmCopies;
short dmDefaultSource;
short dmPrintQuality;
short dmColor;
short dmDuplex;
short dmYResolution;
short dmTTOption;
short dmCollate;
WCHAR dmFormName[CCHFORMNAME];
WORD dmLogPixels;
DWORD dmBitsPerPel;
DWORD dmPelsWidth;
DWORD dmPelsHeight;
DWORD dmDisplayFlags;
DWORD dmDisplayFrequency;
} DEVMODEW;
The DEVMODEW structure contains information about the device initialization and environment of a printer.
Members
dmDeviceName
Specifies the name of the device the driver supports; for example, “PCL/HP LaserJet” in the case of PCL/HP LaserJet®. If the name is greater than CCHDEVICENAME characters in length, the spooler truncates it to fit in the array.
dmSpecVersion
Specifies the version number of the initialization data specification on which the structure is based.
dmDriverVersion
Specifies the printer driver version number assigned by the printer driver developer.
dmSize
Specifies the size, in bytes, of the DEVMODEW structure minus the device-specific dmDriverData member. If an application manipulates only the driver-independent portion of the data, it can use this member to determine the size of the structure without having to account for different versions.
dmDriverExtra
Specifies the number of bytes of private driver data that follow this structure. If a device driver does not use device-specific information, this member should be set to zero.
dmFields
Specifies which of the remaining members in the DEVMODEW structure have been initialized. Bit zero (defined as DM_ORIENTATION) specifies dmOrientation; bit one (defined as DM_PAPERSIZE) specifies dmPaperSize, and so on. A printer driver should support only those members that are appropriate for the printer technology.
dmOrientation
Specifies the paper orientation. This member can be either DMORIENT_PORTRAIT or DMORIENT_LANDSCAPE.
dmPaperSize
Specifies the size of the paper to be printed on. This member can be zero if the length and width of the paper are both specified by the dmPaperLength and dmPaperWidth members. Otherwise, the dmPaperSize member can be set to one of the following predefined values:
| Value | Meaning |
| DMPAPER_LETTER | Letter, 8-1/2 by 11 in. |
| DMPAPER_LEGAL | Legal, 8-1/2 by 14 in. |
| DMPAPER_A4 | A4 Sheet, 210 by 297 mm. |
| DMPAPER_CSHEET | C Sheet, 17 by 22 in. |
| DMPAPER_DSHEET | D Sheet, 22 by 34 in. |
| DMPAPER_ESHEET | E Sheet, 34 by 44 in. |
| DMPAPER_LETTERSMALL | Letter Small, 8-1/2 by 11 in. |
| DMPAPER_TABLOID | Tabloid, 11 by 17 in. |
| DMPAPER_LEDGER | Ledger, 17 by 11 in. |
| DMPAPER_STATEMENT | Statement, 5-1/2 by 8-1/2 in. |
| DMPAPER_EXECUTIVE | Executive, 7-1/4 by 10-1/2 in. |
| DMPAPER_A3 | A3 sheet, 297 by 420 mm. |
| DMPAPER_A4SMALL | A4 small sheet, 210 by 297 mm. |
| DMPAPER_A5 | A5 sheet, 148 by 210 mm. |
| DMPAPER_B4 | B4 sheet, 250 by 354 mm. |
| DMPAPER_B5 | B5 sheet, 182 by 257 mm. |
| DMPAPER_FOLIO | Folio, 8-1/2 by 13 in. |
| DMPAPER_QUARTO | Quarto, 215 by 275 mm. |
| DMPAPER_10X14 | 10 by 14 in. |
| DMPAPER_11X17 | 11 by 17 in. |
| DMPAPER_NOTE | Note, 8-1/2 by 11 in. |
| DMPAPER_ENV_9 | #9 Envelope, 3-7/8 by 8-7/8 in. |
| DMPAPER_ENV_10 | #10 Envelope, 4-1/8 by 9-1/2 in. |
| DMPAPER_ENV_11 | #11 Envelope, 4-1/2 by 10-3/8 in. |
| DMPAPER_ENV_12 | #12 Envelope, 4-3/4 by 11 in. |
| DMPAPER_ENV_14 | #14 Envelope, 5 by 11-1/2 in. |
| DMPAPER_ENV_DL | DL Envelope, 110 by 220 mm. |
| DMPAPER_ENV_C5 | C5 Envelope, 162 by 229 mm. |
| DMPAPER_ENV_C3 | C3 Envelope, 324 by 458 mm. |
| DMPAPER_ENV_C4 | C4 Envelope, 229 by 324 mm. |
| DMPAPER_ENV_C6 | C6 Envelope, 114 by 162 mm. |
| DMPAPER_ENV_C65 | C65 Envelope, 114 by 229 mm. |
| DMPAPER_ENV_B4 | B4 Envelope, 250 by 353 mm. |
| DMPAPER_ENV_B5 | B5 Envelope, 176 by 250 mm. |
| DMPAPER_ENV_B6 | B6 Envelope, 176 by 125 mm. |
| DMPAPER_ENV_ITALY | Italy Envelope, 110 by 230 mm. |
| DMPAPER_ENV_MONARCH | Monarch Envelope, 3-7/8 by 7-1/2 in. |
| DMPAPER_ENV_PERSONAL | 6-3/4 Envelope, 3-5/8 by 6-1/2 in. |
| DMPAPER_FANFOLD_US | US Std Fanfold, 14-7/8 by 11 in. |
| DMPAPER_FANFOLD_STD_GERMAN | German Std Fanfold, 8-1/2 by 12 in. |
| DMPAPER_FANFOLD_LGL_GERMAN | German Legal Fanfold, 8-1/2 by 13 in. |
dmPaperLength
Specifies the length of the paper. This value overrides the length of the paper specified by the dmPaperSize member. This might be necessary if the paper is of a custom size, or the device is a dot matrix printer, which can print a page of arbitrary length. This value, along with all values in this structure that specify a physical length, is specified in units of 1/10 of a millimeter.
dmPaperWidth
Specifies the width of the paper. This value overrides the width of the paper specified by the dmPaperSize member. This value is specified in units of 1/10 of a millimeter.
dmScale
Specifies the factor by which the printed output is to be scaled. The apparent page size is scaled from the physical page size by a factor of dmScale/100. For example, a letter-sized page with a dmScale value of 50 contains as much data as a page of 17 by 22 inches because the output text and graphics are half their original height and width.
dmCopies
Specifies the number of copies printed if the device supports multiple copies.
dmDefaultSource
Reserved; must be zero.
dmPrintQuality
Specifies the printer resolution. There are four predefined device-independent values:
DMRES_HIGH
DMRES_MEDIUM
DMRES_LOW
DMRES_DRAFT
If a positive value is given, it specifies the number of dots per inch (DPI) and is therefore device-dependent.
dmColor
Specifies whether a color printer should print color or monochrome. This member can be one of the following values:
DMCOLOR_COLOR
DMCOLOR_MONOCHROME
dmDuplex
Specifies duplex (double-sided) printing for duplex-capable printers. This member can be one of the following values:
DMDUP_SIMPLEX
DMDUP_HORIZONTAL
DMDUP_VERTICAL
dmYResolution
Specifies the y resolution of the printer, in DPI. If the printer initializes this member, the dmPrintQuality member specifies the x resolution of the printer, in DPI.
dmTTOption
Specifies how TrueType® fonts should be printed. This member can be one of the following values:
| Value | Meaning |
| DMTT_BITMAP | Prints TrueType fonts as graphics. This is the default for dot-matrix printers. |
| DMTT_DOWNLOAD | Downloads TrueType fonts as soft fonts. This is the default for Hewlett-Packard printers that use Printer Control Language (PCL). |
| DMTT_SUBDEV | Substitute device fonts for TrueType fonts. This is the default for PostScript® printers. |
dmCollate
Specifies whether collation should be used when printing multiple copies. This member can be be one of the following values:
| Value | Meaning |
| DMCOLLATE_TRUE | Collate when printing multiple copies. |
| DMCOLLATE_FALSE | Do not collate when printing multiple copies. |
Specifying DMCOLLATE_FALSE provides faster output because the data is sent to a printer only once, no matter how many copies are required.
dmFormName
Specifies the name of the form to use; for example, “Letter” or “Legal”. A complete set of names can be retrieved using the EnumForms function.
dmLogPixels
Specifies the number of log pixels in the x direction. This member should be equal to the ulLogPixels member of the GDIINFO structure.
dmBitsPerPel
Specifies the color resolution of the display device, in bits per pixel. For example: 4 for 16 colors, 8 for 256 colors, or 16 for 65536 colors.
dmPelsWidth
Specifies the width in pixels of the visible device surface.
dmPelsHeight
Specifies the height in pixels of the visible device surface.
dmDisplayFlags
Specifies the device’s display mode. The following are valid flags:
| Value | Meaning |
| DM_GRAYSCALE | Specifies that the display is not a color device. If this flag is not set, color is assumed. |
| DM_INTERLACED | Specifies that the display mode is interlaced. If the flag is not set, noninterlaced is assumed. |
dmDisplayFrequency
Specifies the frequency, in hertz, of the display device in its current mode.
Comments
This structure is an extension of the Windows 3.1 DEVMODE structure.
A device driver’s private data follows the dmDisplayMode member. The number of bytes of private data is specified by the dmDriverExtra member.
An application can set several of these members, like dmCopies and dmOrientation, that are common among several drivers. This allows an application to make simple mode selections without calling the driver-supplied DrvDeviceModes function.
The DEVMODEW structure is followed immediately by dmDriverExtra bytes of driver data. This data is set only by DrvGetModes, and is therefore driver-defined. The driver should not assume that it can calculate the size of the DEVMODEW structure, but instead should use the size specified by the dmSize member.
The driver data begins at the address pointed to by:
PVOID pvDriverData = (PVOID) (((BYTE *) pdm) + (pdm->dmSize));
See Also