 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This structure contains information about a printer environment and device initialization.
typedef
struct_devicemode
{
BCHAR
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
;
BCHAR
dmFormName[CCHFORMNAME]
;
WORD
dmLogPixels
;
DWORD
dmBitsPerPel
;
DWORD
dmPelsWidth
;
DWORD
dmPelsHeight
;
DWORD
dmDisplayFlags
;
DWORD
dmDisplayFrequency
;
}
DEVMODE;
Members
- dmDeviceName
- Unsupported; set to zero.
- dmSpecVersion
- Specifies the version number of the initialization data specification on which the structure is based. Must be initialized to SPEC_VERSION.
- dmDriverVersion
- Unsupported; set to zero.
- dmSize
- Specifies the size, in bytes, of the DEVMODEstructure, 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 DEVMODEstructure being used.
- dmDriverExtra
- Unsupported; set to zero.
- dmFields
- Unsupported; set to zero.
- dmOrientation
- For printer devices only, specifies the orientation of the paper. It is either DMORIENT_PORTRAIT (1) or DMORIENT_LANDSCAPE (2).
- dmPaperSize
- For printer devices only, specifies the size of the paper to
print on. This member is one of the following predefined values.
Value Description DMPAPER_LETTER Letter, 8 1/2- by 11-inches DMPAPER_A4 A4 Sheet, 210- by 297-millimeters - dmPaperLength
- Unsupported; set to zero.
- dmPaperWidth
- Unsupported; set to zero.
- dmScale
- Unsupported; set to zero.
- dmCopies
- Unsupported; set to zero.
- DmDefaultSource
- Unsupported; set to zero.
- dmPrintQuality
- Specifies the printer resolution. The following are predefined
device-independent values:
- DMRES_DRAFT
- DMRES_HIGH
- dmColor
- Switches between color and monochrome on color printers. The following are possible values:
- DMCOLOR_COLOR
- DMCOLOR_MONOCHROME
- dmDuplex
- Unsupported; set to zero.
- dmYResolution
- Unsupported; set to zero.
- dmTTOption
- Unsupported; set to zero.
- dmCollate
- Unsupported; set to zero.
- dmFormName
- Unsupported; set to zero.
- dmLogPixels
- Unsupported; set to zero.
- dmBitsPerPel
- Unsupported; set to zero.
- dmPelsWidth
- Unsupported; set to zero.
- dmPelsHeight
- Unsupported; set to zero.
- dmDisplayFlags
- Unsupported; set to zero.
- dmDisplayFrequency
- Unsupported; set to zero.
Remarks
A device driver's private data follows the public portion of the DEVMODEstructure. The size of the public data can vary for different versions of the structure. The dmSizemember specifies the number of bytes of public data, and the dmDriverExtramember specifies the number of bytes of private data.
All unsupported members should be initialized to zero.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 2.0 and later Wingdi.h Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also