DEVMODE

typedef struct _devicemode {    // dvmd  
    TCHAR  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;
    TCHAR  dmFormName[CCHFORMNAME];
    WORD   dmUnusedPadding;
    USHORT dmBitsPerPel;
    DWORD  dmPelsWidth;
    DWORD  dmPelsHeight;
    DWORD  dmDisplayFlags;
    DWORD  dmDisplayFrequency;
    WORD   dmICMMethod;
    WORD   dmICMIntent;
    WORD   dmMediaType;
    WORD   dmDitherType;
    DWORD  dmReserved1;
    DWORD  dmReserved2;
} DEVMODE;

Contains information about the device initialization and environment of a printer. An application passes this structure to the DeviceCapabilities and ExtDeviceMode functions.

dmDeviceName

Name of the device that the driver supports (for example, "PCL/HP LaserJet" in the case of PCL/HP LaserJet®). This name is unique among device drivers.

dmSpecVersion

Version number of the initialization data specification on which the structure is based. The current version is 0x0400

dmDriverVersion

Printer driver version number assigned by the printer driver developer.

dmSize

Size, in bytes, of the DEVMODE structure except the dmDriverData (device-specific) member. If an application manipulates only the driver-independent portion of the data, it can use this member to determine the length of the structure without having to account for different versions.

dmDriverExtra

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 zero.

dmFields

Array of flags that determine whether the printer driver uses or ignores the remaining members in the DEVMODE structure. If a flag is set, the driver uses the value in the corresponding member; otherwise, the driver ignores it. A printer driver supports only those members that are appropriate for the printer technology. Can be a combination of these values:

dmOrientation

Paper orientation. Can be either DMORIENT_PORTRAIT (1) or DMORIENT_LANDSCAPE (2).

dmPaperSize

Paper size. Can be one of these values:

dmPaperLength

Length of the paper, in portrait mode. Use this member to define custom paper sizes or for devices such as dot-matrix printers, which 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. The dmPaperSize member must specify the DMPAPER_USER value; otherwise, this member is ignored.

dmPaperWidth

Width of the paper, in portrait mode. The dmPaperSize member must specify the DMPAPER_USER value; otherwise, this member is ignored.

dmScale

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

Number of copies printed if the device supports multiple-page copies.

dmDefaultSource

Default paper bin from which the paper is fed. Can be one of the following predefined values, or a driver defined value greater than the value of DMBIN_USER.

dmPrintQuality

Printer resolution. There are four predefined device-independent values:

If a positive value is given, it specifies the number of dots per inch (DPI) and is, therefore, device dependent.

dmColor

Color flag. Selects either color or monochrome on color printers. Can be one of these values:

dmDuplex

Duplex flag. Selects duplex or double-sided printing for printers capable of duplex printing. Can be one of these values:

dmYResolution

Vertical resolution, in dots per inch, of the printer. If the printer initializes this member, the dmPrintQuality member specifies the horizontal resolution, in dots per inch, of the printer.

dmTTOption

TrueType® flag. Specifies how TrueType fonts should be printed. Can be one of these values:

dmCollate

Collate flag. Specifies whether collation should be used when printing multiple copies. Can be one of these values:

Using DMCOLLATE_FALSE provides faster, more efficient output, since the data is sent to a page printer just once, no matter how many copies are required. The printer is simply told to print the page again.

dmFormName

Name of the form to use (for example, "Letter" or "Legal"). A complete set of names can be retrieved by using the EnumForms function.

dmUnusedPadding

Reserved; used to align the structure to a doubleword boundary. This member should not be used or referenced. Its name and usage can change in future releases.

dmBitsPerPel

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 65536 colors).

dmPelsWidth

Width, in pixels, of the visible device surface.

dmPelsHeight

Height, in pixels, of the visible device surface.

dmDisplayFlags

Device display-mode flag. Can be one of these values:

dmDisplayFrequency

Frequency, in hertz (cycles per second), of the display device in a particular mode.

dmICMMethod

ICM method flag. Determines how ICM is handled. For a non-ICM application, this member determines if ICM is enabled of disabled. For ICM applications, Windows examines this member to determine how to handle ICM support. Can be one of these values:

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

dmICMIntent

ICM-intent flag. Indicates which of the three possible color matching intents should be used by default. This member is primarily for non-ICM applications. ICM application can establish intent by using the ICM functions. Can be one of these values:

dmMediaType

Type of media being printed on. Can be one of the following predefined values, or a driver defined value greater than the value of DMMEDIA_USER.

dmDitherType

Dithering-type flag. Specifies how dithering is to be done.. Can be one of the following predefined values, or a driver defined value greater than the value of DMDITHER_USER.

dmReserved1

Not used; must be zero.

dmReserved2

Not used; must be zero.

A device driver's private data follows immediately after the end of the structure. The number of bytes of private data is specified by the dmDriverExtra member.

See also ExtDeviceMode