The DEVMODE data structure contains information about the initialization and environment of a printer or a display device.

typedef struct _devicemode { 
  BCHAR  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; 
    };
    POINTL dmPosition;
    DWORD  dmDisplayOrientation;
    DWORD  dmDisplayFixedOutput;
  };

  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;
  }
  DWORD  dmDisplayFrequency; 
#if(WINVER >= 0x0400) 
  DWORD  dmICMMethod;
  DWORD  dmICMIntent;
  DWORD  dmMediaType;
  DWORD  dmDitherType;
  DWORD  dmReserved1;
  DWORD  dmReserved2;
#if (WINVER >= 0x0500) || (_WIN32_WINNT >= 0x0400)
  DWORD  dmPanningWidth;
  DWORD  dmPanningHeight;
#endif
#endif /* WINVER >= 0x0400 */
} DEVMODE; 

Members

dmDeviceName

A zero-terminated character array that specifies the "friendly" name of the printer or display; for example, "PCL/HP LaserJet" in the case of PCL/HP LaserJet. This string is unique among device drivers. Note that this name may be truncated to fit in the dmDeviceName array.

dmSpecVersion

Specifies the version number of the initialization data specification on which the structure is based. To ensure the correct version is used for any operating system, use DM_SPECVERSION.

dmDriverVersion

Specifies the driver version number assigned by the driver developer.

dmSize

Specifies the size, in bytes, of the DEVMODE structure, not including any private driver-specific data that might follow the structure's public members. Set this member to sizeof(DEVMODE) to indicate the version of the DEVMODE structure being used.

dmDriverExtra

Contains the number of bytes of private driver-data that follow this structure. If a device driver does not use device-specific information, set this member to zero.

dmFields

Specifies whether certain members of the DEVMODE structure have been initialized. If a member is initialized, its corresponding bit is set, otherwise the bit is clear. A driver supports only those DEVMODE members that are appropriate for the printer or display technology.

The following values are defined, and are listed here with the corresponding structure members.

Value	Structure member
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	Windows 2000/XP: dmPanningWidth
DM_PANNINGHEIGHT	Windows 2000/XP: dmPanningHeight

dmOrientation

For printer devices only, selects the orientation of the paper. This member can be either DMORIENT_PORTRAIT (1) or DMORIENT_LANDSCAPE (2).

dmPaperSize

For printer devices only, selects the size of the paper to print on. This member can be set to zero if the length and width of the paper are both set by the dmPaperLength and dmPaperWidth members. Otherwise, the dmPaperSize member can be set to a device specific value greater than or equal to DMPAPER_USER or to one of the following predefined values.

Value	Meaning
DMPAPER_LETTER	Letter, 8 1/2- by 11-inches
DMPAPER_LEGAL	Legal, 8 1/2- by 14-inches
DMPAPER_9X11	9- by 11-inch sheet
DMPAPER_10X11	10- by 11-inch sheet
DMPAPER_10X14	10- by 14-inch sheet
DMPAPER_15X11	15- by 11-inch sheet
DMPAPER_11X17	11- by 17-inch sheet
DMPAPER_12X11	Windows 98/Me, Windows NT 4.0 and later: 12- by 11-inch sheet
DMPAPER_A2	A2 sheet, 420 x 594-millimeters
DMPAPER_A3	A3 sheet, 297- by 420-millimeters
DMPAPER_A3_EXTRA	A3 Extra 322 x 445-millimeters
DMPAPER_A3_EXTRA_TRAVERSE	A3 Extra Transverse 322 x 445-millimeters
DMPAPER_A3_ROTATED	Windows 98/Me, Windows NT 4.0 and later: A3 rotated sheet, 420- by 297-millimeters
DMPAPER_A3_TRAVERSE	A3 Transverse 297 x 420-millimeters
DMPAPER_A4	A4 sheet, 210- by 297-millimeters
DMPAPER_A4_EXTRA	A4 sheet, 9.27 x 12.69 inches
DMPAPER_A4_PLUS	A4 Plus 210 x 330-millimeters
DMPAPER_A4_ROTATED	Windows 98/Me, Windows NT 4.0 and later: A4 rotated sheet, 297- by 210-millimeters
DMPAPER_A4SMALL	A4 small sheet, 210- by 297-millimeters
DMPAPER_A4_TRANSVERSE	A4 Transverse 210 x 297 millimeters
DMPAPER_A5	A5 sheet, 148- by 210-millimeters
DMPAPER_A5_EXTRA	A5 Extra 174 x 235-millimeters
DMPAPER_A5_ROTATED	Windows 98/Me, Windows NT 4.0 and later: A5 rotated sheet, 210- by 148-millimeters
DMPAPER_A5_TRANSVERSE	A5 Transverse 148 x 210-millimeters
DMPAPER_A6	Windows 98/Me, Windows NT 4.0 and later: A6 sheet, 105- by 148-millimeters
DMPAPER_A6_ROTATED	Windows 98/Me, Windows NT 4.0 and later: A6 rotated sheet, 148- by 105-millimeters
DMPAPER_A_PLUS	SuperA/A4 227 x 356 -millimeters
DMPAPER_B4	B4 sheet, 250- by 354-millimeters
DMPAPER_B4_JIS_ROTATED	Windows 98/Me, Windows NT 4.0 and later: B4 (JIS) rotated sheet, 364- by 257-millimeters
DMPAPER_B5	B5 sheet, 182- by 257-millimeter paper
DMPAPER_B5_EXTRA	B5 (ISO) Extra 201 x 276-millimeters
DMPAPER_B5_JIS_ROTATED	Windows 98/Me, Windows NT 4.0 and later: B5 (JIS) rotated sheet, 257- by 182-millimeters
DMPAPER_B6_JIS	Windows 98/Me, Windows NT 4.0 and later: B6 (JIS) sheet, 128- by 182-millimeters
DMPAPER_B6_JIS_ROTATED	Windows 98/Me, Windows NT 4.0 and later: B6 (JIS) rotated sheet, 182- by 128-millimeters
DMPAPER_B_PLUS	SuperB/A3 305 x 487-millimeters
DMPAPER_CSHEET	C Sheet, 17- by 22-inches
DMPAPER_DBL_JAPANESE_POSTCARD	Windows 98/Me, Windows NT 4.0 and later: Double Japanese Postcard, 200- by 148-millimeters
DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED	Windows 98/Me, Windows NT 4.0 and later: Double Japanese Postcard Rotated, 148- by 200-millimeters
DMPAPER_DSHEET	D Sheet, 22- by 34-inches
DMPAPER_ENV_9	#9 Envelope, 3 7/8- by 8 7/8-inches
DMPAPER_ENV_10	#10 Envelope, 4 1/8- by 9 1/2-inches
DMPAPER_ENV_11	#11 Envelope, 4 1/2- by 10 3/8-inches
DMPAPER_ENV_12	#12 Envelope, 4 3/4- by 11-inches
DMPAPER_ENV_14	#14 Envelope, 5- by 11 1/2-inches
DMPAPER_ENV_C5	C5 Envelope, 162- by 229-millimeters
DMPAPER_ENV_C3	C3 Envelope, 324- by 458-millimeters
DMPAPER_ENV_C4	C4 Envelope, 229- by 324-millimeters
DMPAPER_ENV_C6	C6 Envelope, 114- by 162-millimeters
DMPAPER_ENV_C65	C65 Envelope, 114- by 229-millimeters
DMPAPER_ENV_B4	B4 Envelope, 250- by 353-millimeters
DMPAPER_ENV_B5	B5 Envelope, 176- by 250-millimeters
DMPAPER_ENV_B6	B6 Envelope, 176- by 125-millimeters
DMPAPER_ENV_DL	DL Envelope, 110- by 220-millimeters
DMPAPER_ENV_INVITE	Envelope Invite 220 x 220 mm
DMPAPER_ENV_ITALY	Italy Envelope, 110- by 230-millimeters
DMPAPER_ENV_MONARCH	Monarch Envelope, 3 7/8- by 7 1/2-inches
DMPAPER_ENV_PERSONAL	6 3/4 Envelope, 3 5/8- by 6 1/2-inches
DMPAPER_ESHEET	E Sheet, 34- by 44-inches
DMPAPER_EXECUTIVE	Executive, 7 1/4- by 10 1/2-inches
DMPAPER_FANFOLD_US	US Std Fanfold, 14 7/8- by 11-inches
DMPAPER_FANFOLD_STD_GERMAN	German Std Fanfold, 8 1/2- by 12-inches
DMPAPER_FANFOLD_LGL_GERMAN	German Legal Fanfold, 8 - by 13-inches
DMPAPER_FOLIO	Folio, 8 1/2- by 13-inch paper
DMPAPER_ISO_B4	B4 (ISO) 250- by 353-millimeters paper
DMPAPER_JAPANESE_POSTCARD	Japanese Postcard, 100- by 148-millimeters
DMPAPER_JAPANESE_POSTCARD_ROTATED	Windows 98/Me, Windows NT 4.0 and later: Japanese Postcard Rotated, 148- by 100-millimeters
DMPAPER_JENV_CHOU3	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope Chou #3
DMPAPER_JENV_CHOU3_ROTATED	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope Chou #3 Rotated
DMPAPER_JENV_CHOU4	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope Chou #4
DMPAPER_JENV_CHOU4_ROTATED	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope Chou #4 Rotated
DMPAPER_JENV_KAKU2	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope Kaku #2
DMPAPER_JENV_KAKU2_ROTATED	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope Kaku #2 Rotated
DMPAPER_JENV_KAKU3	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope Kaku #3
DMPAPER_JENV_KAKU3_ROTATED	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope Kaku #3 Rotated
DMPAPER_JENV_YOU4	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope You #4
DMPAPER_JENV_YOU4_ROTATED	Windows 98/Me, Windows NT 4.0 and later: Japanese Envelope You #4 Rotated
DMPAPER_LAST	Windows 2000/XP: DMPAPER_PENV_10_ROTATED
DMPAPER_LEDGER	Ledger, 17- by 11-inches
DMPAPER_LEGAL_EXTRA	Legal Extra 9 1/2 x 15 inches.
DMPAPER_LETTER_EXTRA	Letter Extra 9 1/2 x 12 inches.
DMPAPER_LETTER_EXTRA_TRANSVERSE	Letter Extra Transverse 9 1/2 x 12 inches.
DMPAPER_LETTER_ROTATED	Letter Rotated 11 by 8 1/2 inches
DMPAPER_LETTERSMALL	Letter Small, 8 1/2- by 11-inches
DMPAPER_LETTER_TRANSVERSE	Letter Transverse 8 1/2 x 11-inches
DMPAPER_NOTE	Note, 8 1/2- by 11-inches
DMPAPER_P16K	Windows 98/Me, Windows NT 4.0 and later: PRC 16K, 146- by 215-millimeters
DMPAPER_P16K_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC 16K Rotated, 215- by 146-millimeters
DMPAPER_P32K	Windows 98/Me, Windows NT 4.0 and later: PRC 32K, 97- by 151-millimeters
DMPAPER_P32K_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC 32K Rotated, 151- by 97-millimeters
DMPAPER_P32KBIG	Windows 98/Me, Windows NT 4.0 and later: PRC 32K(Big) 97- by 151-millimeters
DMPAPER_P32KBIG_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC 32K(Big) Rotated, 151- by 97-millimeters
DMPAPER_PENV_1	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #1, 102- by 165-millimeters
DMPAPER_PENV_1_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #1 Rotated, 165- by 102-millimeters
DMPAPER_PENV_2	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #2, 102- by 176-millimeters
DMPAPER_PENV_2_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #2 Rotated, 176- by 102-millimeters
DMPAPER_PENV_3	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #3, 125- by 176-millimeters
DMPAPER_PENV_3_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #3 Rotated, 176- by 125-millimeters
DMPAPER_PENV_4	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #4, 110- by 208-millimeters
DMPAPER_PENV_4_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #4 Rotated, 208- by 110-millimeters
DMPAPER_PENV_5	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #5, 110- by 220-millimeters
DMPAPER_PENV_5_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #5 Rotated, 220- by 110-millimeters
DMPAPER_PENV_6	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #6, 120- by 230-millimeters
DMPAPER_PENV_6_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #6 Rotated, 230- by 120-millimeters
DMPAPER_PENV_7	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #7, 160- by 230-millimeters
DMPAPER_PENV_7_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #7 Rotated, 230- by 160-millimeters
DMPAPER_PENV_8	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #8, 120- by 309-millimeters
DMPAPER_PENV_8_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #8 Rotated, 309- by 120-millimeters
DMPAPER_PENV_9	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #9, 229- by 324-millimeters
DMPAPER_PENV_9_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #9 Rotated, 324- by 229-millimeters
DMPAPER_PENV_10	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #10, 324- by 458-millimeters
DMPAPER_PENV_10_ROTATED	Windows 98/Me, Windows NT 4.0 and later: PRC Envelope #10 Rotated, 458- by 324-millimeters
DMPAPER_QUARTO	Quarto, 215- by 275-millimeter paper
DMPAPER_STATEMENT	Statement, 5 1/2- by 8 1/2-inches
DMPAPER_TABLOID	Tabloid, 11- by 17-inches
DMPAPER_TABLOID_EXTRA	Tabloid, 11.69 x 18-inches

dmPaperLength

For printer devices only, overrides the length of the paper specified by the dmPaperSize member, either for custom paper sizes or for devices such as dot-matrix printers that can print on a page of arbitrary length. These values, along with all other values in this structure that specify a physical length, are in tenths of a millimeter.

dmPaperWidth

For printer devices only, overrides the width of the paper specified by the dmPaperSize member.

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 would contain as much data as a page of 17- by 22-inches because the output text and graphics would be half their original height and width.

dmCopies

Selects the number of copies printed if the device supports multiple-page copies.

dmDefaultSource

Specifies the paper source. To retrieve a list of the available paper sources for a printer, use the DeviceCapabilities function with the DC_BINS flag.

This member can be one of the following values, or it can be a device-specific value greater than or equal to DMBIN_USER.

DMBIN_AUTO DMBIN_CASSETTE DMBIN_ENVELOPE DMBIN_ENVMANUAL DMBIN_FIRST DMBIN_FORMSOURCE DMBIN_LARGECAPACITY DMBIN_LARGEFMT

DMBIN_LAST DMBIN_LOWER DMBIN_MANUAL DMBIN_MIDDLE DMBIN_ONLYONE DMBIN_TRACTOR DMBIN_SMALLFMT DMBIN_UPPER

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 specified, it specifies the number of dots per inch (DPI) and is therefore device dependent.

dmPosition

Windows 98/Me, Windows 2000/XP: For display devices only, a POINTL structure that indicates the positional coordinates of the display device in reference to the desktop area. The primary display device is always located at coordinates (0,0).

dmDisplayOrientation

Windows XP: For display devices only, the orientation at which images should be presented. If DM_DISPLAYORIENTATION is not set, this member must be zero. If DM_DISPLAYORIENTATION is set, this member must be one of the following values

Value	Meaning
DMDO_DEFAULT	The display orientation is the natural orientation of the display device; it should be used as the default.
DMDO_90	The display orientation is rotated 90 degrees (measured clockwise) from DMDO_DEFAULT.
DMDO_180	The display orientation is rotated 180 degrees (measured clockwise) from DMDO_DEFAULT.
DMDO_270	The display orientation is rotated 270 degrees (measured clockwise) from DMDO_DEFAULT.

To deterimine whether the display orientation is portrait or landscape orientation, check the ratio of dmPelsWidth to dmPelsHeight.

dmDisplayFixedOutput

Windows XP: For fixed-resolution display devices only, how the display presents a low-resolution mode on a higher-resolution display. For example, if a display device's resolution is fixed at 1024 x 768 pixels but its mode is set to 640 x 480 pixels, the device can either display a 640 x 480 image somewhere in the interior of the 1024 x 768 screen space or stretch the 640 x 480 image to fill the larger screen space. If DM_DISPLAYFIXEDOUTPUT is not set, this member must be zero. If DM_DISPLAYFIXEDOUTPUT is set, this member must be one of the following values.

Value	Meaning
DMDFO_DEFAULT	The display's default setting.
DMDFO_CENTER	The low-resolution image is centered in the larger screen space.
DMDFO_STRETCH	The low-resolution image is stretched to fill the larger screen space.

dmColor

Switches between color and monochrome on color printers. Following are the possible values:

DMCOLOR_COLOR
DMCOLOR_MONOCHROME

dmDuplex

Selects duplex or double-sided printing for printers capable of duplex printing. Following are the possible values.

Value	Meaning
DMDUP_SIMPLEX	Normal (nonduplex) printing.
DMDUP_HORIZONTAL	Short-edge binding, that is, the long edge of the page is horizontal.
DMDUP_VERTICAL	Long-edge binding, that is, the long edge of the page is vertical.

dmYResolution

Specifies the y-resolution, in dots per inch, of the printer. If the printer initializes this member, the dmPrintQuality member specifies the x-resolution, in dots per inch, of the printer.

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 action for dot-matrix printers.
DMTT_DOWNLOAD	Downloads TrueType fonts as soft fonts. This is the default action for Hewlett-Packard printers that use Printer Control Language (PCL).
DMTT_DOWNLOAD_OUTLINE	Window 95/98/Me, Windows NT 4.0 and later: Downloads TrueType fonts as outline soft fonts.
DMTT_SUBDEV	Substitutes device fonts for TrueType fonts. This is the default action for PostScript printers.

dmUnusedPadding

Used to align the structure to a DWORD boundary. This should not be used or referenced. Its name and usage is reserved, and can change in future releases.

dmCollate

Specifies whether collation should be used when printing multiple copies. (This member is ignored unless the printer driver indicates support for collation by setting the dmFields member to DM_COLLATE.) This member can be one of the following values.

Value	Meaning
DMCOLLATE_TRUE	Collate when printing multiple copies.
DMCOLLATE_FALSE	Do not collate when printing multiple copies.

dmFormName

Windows NT/2000/XP: A zero-terminated character array that specifies the name of the form to use; for example, "Letter" or "Legal". A complete set of names can be retrieved by using the EnumForms function.

Windows 95/98/Me: Printer drivers do not use this member.

dmLogPixels

Specifies the number of pixels per logical inch. Printer drivers do not use this member.

dmBitsPerPel

Specifies the color resolution, in bits per pixel, of the display device (for example: 4 bits for 16 colors, 8 bits for 256 colors, or 16 bits for 65,536 colors). Display drivers use this member, for example, in the ChangeDisplaySettings function. Printer drivers do not use this member.

dmPelsWidth

Specifies the width, in pixels, of the visible device surface. Display drivers use this member, for example, in the ChangeDisplaySettings function. Printer drivers do not use this member.

dmPelsHeight

Specifies the height, in pixels, of the visible device surface. Display drivers use this member, for example, in the ChangeDisplaySettings function. Printer drivers do not use this member.

dmDisplayFlags

Specifies the device's display mode. This member can be a combination of the following values.

Value	Meaning
DM_GRAYSCALE	Specifies that the display is a noncolor 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.

Display drivers use this member, for example, in the ChangeDisplaySettings function. Printer drivers do not use this member.

dmNup

Specifies where the NUP is done. It can be one of the following.

Value	Meaning
DMNUP_SYSTEM	The print spooler does the NUP.
DMNUP_ONEUP	The application does the NUP.

dmDisplayFrequency

Specifies the frequency, in hertz (cycles per second), of the display device in a particular mode. This value is also known as the display device's vertical refresh rate. Display drivers use this member. It is used, for example, in the ChangeDisplaySettings function. Printer drivers do not use this member.

When you call the EnumDisplaySettings function, the dmDisplayFrequency member may return with the value 0 or 1. These values represent the display hardware's default refresh rate. This default rate is typically set by switches on a display card or computer motherboard, or by a configuration program that does not use display functions such as ChangeDisplaySettings.

dmICMMethod

Windows 95/98/Me; Windows 2000/XP: Specifies how ICM is handled. For a non-ICM application, this member determines if ICM is enabled or disabled. For ICM applications, the system examines this member to determine how to handle ICM support. This member can be one of the following predefined values, or a driver-defined value greater than or equal to the value of DMICMMETHOD_USER.

Value	Meaning
DMICMMETHOD_NONE	Specifies that ICM is disabled.
DMICMMETHOD_SYSTEM	Specifies that ICM is handled by Windows.
DMICMMETHOD_DRIVER	Specifies that ICM is handled by the device driver.
DMICMMETHOD_DEVICE	Specifies that ICM is handled by the destination device.

The printer driver must provide a user interface for setting this member. Most printer drivers support only the DMICMMETHOD_SYSTEM or DMICMMETHOD_NONE value. Drivers for PostScript printers support all values.

dmICMIntent

Windows 95/98/Me, Windows 2000/XP: Specifies which color matching method, or intent, should be used by default. This member is primarily for non-ICM applications. ICM applications can establish intents by using the ICM functions. This member can be one of the following predefined values, or a driver defined value greater than or equal to the value of DMICM_USER.

Value	Meaning
DMICM_ABS_COLORIMETRIC	Color matching should optimize to match the exact color requested without white point mapping. This value is most appropriate for use with proofing.
DMICM_COLORIMETRIC	Color matching should optimize to match the exact color requested. This value is most appropriate for use with business logos or other images when an exact color match is desired.
DMICM_CONTRAST	Color matching should optimize for color contrast. This value is the most appropriate choice for scanned or photographic images when dithering is desired.
DMICM_SATURATE	Color matching should optimize for color saturation. This value is the most appropriate choice for business graphs when dithering is not desired.

dmMediaType

Windows 95/98/Me, Windows 2000/XP: Specifies the type of media being printed on. The member can be one of the following predefined values, or a driver-defined value greater than or equal to the value of DMMEDIA_USER.

Value	Meaning
DMMEDIA_STANDARD	Plain paper.
DMMEDIA_GLOSSY	Glossy paper.
DMMEDIA_TRANSPARENCY	Transparent film.

Windows XP: To retrieve a list of the available media types for a printer, use the DeviceCapabilities function with the DC_MEDIATYPES flag.

dmDitherType

Windows 95/98/Me, Windows 2000/XP: Specifies how dithering is to be done. The member can be one of the following predefined values, or a driver-defined value greater than or equal to the value of DMDITHER_USER.

Value	Meaning
DMDITHER_NONE	No dithering.
DMDITHER_COARSE	Dithering with a coarse brush.
DMDITHER_FINE	Dithering with a fine brush.
DMDITHER_LINEART	Line art dithering, a special dithering method that produces well defined borders between black, white, and gray scaling. It is not suitable for images that include continuous graduations in intensity and hue, such as scanned photographs.
DMDITHER_ERRORDIFFUSION	Windows 95/98/Me: Dithering in which an algorithm is used to spread, or diffuse, the error of approximating a specified color over adjacent pixels. In contrast, DMDITHER_COARSE, DMDITHER_FINE, and DMDITHER_LINEART use patterned halftoning to approximate a color..
DMDITHER_GRAYSCALE	Device does gray scaling.

dmReserved1

Windows 95/98/Me, Windows 2000/XP: Not used; must be zero.

dmReserved2

Windows 95/98/Me, Windows 2000/XP: Not used; must be zero.

dmPanningWidth

Windows NT/2000/XP: This member must be zero.

Windows 95/98/Me: This member is not supported.

dmPanningHeight

Windows NT/2000/XP: This member must be zero.

Windows 95/98/Me: This member is not supported.

Remarks

A device driver's private data follows the public portion of the DEVMODE structure. The size of the public data can vary for different versions of the structure. The dmSize member specifies the number of bytes of public data, and the dmDriverExtra member specifies the number of bytes of private data.

Requirements

  Windows NT/2000/XP/Vista: Included in Windows NT 3.1 and later.
  Windows 95/98/Me: Included in Windows 95 and later.
  Header: Declared in Wingdi.h; include Windows.h.
  Unicode: Declared as Unicode and ANSI structures.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Structures, AdvancedDocumentProperties, ChangeDisplaySettings, CreateDC, CreateIC, DeviceCapabilities, DocumentProperties, EnumDisplaySettings, OpenPrinter