DEVMODEA 结构 （wingdi.h）

DEVMODE 数据结构包含有关打印机或显示设备的初始化和环境的信息。

语法

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;

成员

dmDeviceName[CCHDEVICENAME]

一个零终止字符数组，指定打印机或显示器的“友好”名称;例如，对于 PCL/HP LaserJet，则为“PCL/HP LaserJet”。 此字符串在设备驱动程序中是唯一的。 请注意，此名称可能会被截断，以适应 dmDeviceName 数组。

dmSpecVersion

结构所基于的初始化数据规范的版本号。 若要确保正确版本用于任何操作系统，请使用DM_SPECVERSION。

dmDriverVersion

驱动程序开发人员分配的驱动程序版本号。

dmSize

指定 DEVMODE 结构的大小（以字节为单位）不包括可能遵循结构公共成员的任何专用驱动程序特定数据。 将此成员设置为 sizeof (DEVMODE)，以指示正在使用的 DEVMODE 结构的版本。

dmDriverExtra

包含遵循此结构的专用驱动程序数据字节数。 如果设备驱动程序不使用特定于设备的信息，请将此成员设置为零。

dmFields

指定是否已初始化 DEVMODE 结构的某些成员。 如果初始化成员，则会设置其相应的位，否则该位是明确的。 驱动程序仅支持那些适合打印机或显示技术 DEVMODE 的成员 成员。

定义了以下值，此处列出了相应的结构成员。

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmOrientation

仅对于打印机设备，请选择纸张的方向。 此成员可以是DMORIENT_PORTRAIT（1）或DMORIENT_LANDSCAPE（2）。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

仅对于打印机设备，选择要打印的纸张大小。 如果纸张的长度和宽度均由 dmPaperLength 和 dmPaperWidth 成员设置，则可以将此成员设置为零。 否则，可以将 dmPaperSize 成员设置为大于或等于DMPAPER_USER或以下预定义值之一的设备特定值。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength

对于打印机设备，请覆盖由 dmPaperSize 成员指定的纸张长度，无论是针对自定义纸张大小，还是对于可以在任意长度的页面上打印的点矩阵打印机等设备。 这些值以及此结构中指定物理长度的所有其他值以十分之几毫米为单位。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth

仅对于打印机设备，将覆盖由 dmPaperSize 成员指定的纸张宽度。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale

指定要缩放打印输出的因子。 明显的页面大小按 dmScale /100 的系数从物理页面大小缩放。 例如，dmScale 值为 50 的字母大小的页面将包含与 17 英寸到 22 英寸页一样多的数据，因为输出文本和图形是其原始高度和宽度的一半。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies

如果设备支持多页副本，请选择打印的副本数。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource

指定纸张源。 若要检索打印机的可用纸张源列表，请使用具有DC_BINS标志的 DeviceCapabilities 函数。

此成员可以是以下值之一，也可以是设备特定的值，该值大于或等于DMBIN_USER。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality

指定打印机分辨率。 有四个与设备无关的预定义值：

如果指定了正值，则指定每英寸点数（DPI），因此依赖于设备。

DUMMYUNIONNAME.dmPosition

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition

仅对于显示设备，POINTL 结构，该结构指示显示设备在对桌面区域的引用中的位置坐标。 主显示设备始终位于坐标（0,0）。

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation

对于仅显示设备，应显示图像的方向。 如果未设置DM_DISPLAYORIENTATION，则此成员必须为零。 如果设置了DM_DISPLAYORIENTATION，则此成员必须是以下值之一

若要确定显示方向是纵向还是横向方向，请检查 dmPelsWidth 与 dmPelsHeight的比例。

Windows 2000：不支持 。

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

仅对于固定分辨率显示设备，显示器在高分辨率显示器上如何呈现低分辨率模式。 例如，如果显示设备的分辨率固定在 1024 x 768 像素，但其模式设置为 640 x 480 像素，则设备可以在 1024 x 768 屏幕空间的内部某处显示 640 x 480 图像，或者拉伸 640 x 480 图像以填充更大的屏幕空间。 如果未设置DM_DISPLAYFIXEDOUTPUT，则此成员必须为零。 如果设置了DM_DISPLAYFIXEDOUTPUT，则此成员必须是以下值之一。

Windows 2000：不支持 。

dmColor

在颜色打印机上切换颜色和单色。 以下是可能的值：

• DMCOLOR_COLOR
• DMCOLOR_MONOCHROME

dmDuplex

为能够双面打印的打印机选择双面打印或双面打印。 下面是可能的值。

dmYResolution

指定打印机的 y 分辨率（以每英寸点为单位）。 如果打印机初始化此成员，则 dmPrintQuality 成员指定打印机的 x 分辨率（以点/英寸为单位）。

dmTTOption

指定应如何打印 TrueType 字体。 此成员可以是以下值之一。

dmCollate

指定打印多个副本时是否应使用排序规则。 （除非打印机驱动程序通过将 dmFields 成员设置为DM_COLLATE来指示对排序规则的支持，否则将忽略此成员。此成员可以是以下值之一。

dmFormName[CCHFORMNAME]

一个零终止字符数组，指定要使用的窗体的名称;例如，“Letter”或“Legal”。 可以使用 EnumForms 函数检索完整的名称集。

dmLogPixels

每个逻辑英寸的像素数。 打印机驱动程序不使用此成员。

dmBitsPerPel

指定显示设备的颜色分辨率（例如：4 位，16 种颜色，8 位，256 种颜色）或 16 位（65,536 种颜色）。 显示驱动程序使用此成员，例如，在 ChangeDisplaySettings 函数中。 打印机驱动程序不使用此成员。

dmPelsWidth

指定可见设备图面的宽度（以像素为单位）。 显示驱动程序使用此成员，例如，在 ChangeDisplaySettings 函数中。 打印机驱动程序不使用此成员。

dmPelsHeight

指定可见设备图面的高度（以像素为单位）。 显示驱动程序使用此成员，例如，在 ChangeDisplaySettings 函数中。 打印机驱动程序不使用此成员。

DUMMYUNIONNAME2

DUMMYUNIONNAME2.dmDisplayFlags

指定设备的显示模式。 此成员可以是以下值的组合。

显示驱动程序使用此成员，例如，在 ChangeDisplaySettings 函数中。 打印机驱动程序不使用此成员。

DUMMYUNIONNAME2.dmNup

指定 NUP 的完成位置。 它可以是下列项之一。

dmDisplayFrequency

指定特定模式下显示设备的频率（每秒周期数）。 此值也称为显示设备的垂直刷新速率。 显示驱动程序使用此成员。 例如，它在 ChangeDisplaySettings 函数中使用。 打印机驱动程序不使用此成员。

调用 EnumDisplaySettings 函数时，dmDisplayFrequency 成员可能会返回值为 0 或 1。 这些值表示显示硬件的默认刷新速率。 此默认速率通常由显示卡或计算机主板上的开关或不使用显示功能（如 ChangeDisplaySettings）的配置程序设置。

dmICMMethod

指定如何处理 ICM。 对于非 ICM 应用程序，此成员确定 ICM 是启用或禁用的。 对于 ICM 应用程序，系统将检查此成员以确定如何处理 ICM 支持。 此成员可以是以下预定义值之一，也可以是大于或等于DMICMMETHOD_USER值的驱动程序定义值之一。

打印机驱动程序必须提供用于设置此成员的用户界面。 大多数打印机驱动程序仅支持DMICMMETHOD_SYSTEM或DMICMMETHOD_NONE值。 PostScript 打印机的驱动程序支持所有值。

dmICMIntent

指定默认应使用哪种颜色匹配方法或意向。 此成员主要用于非 ICM 应用程序。 ICM 应用程序可以使用 ICM 函数建立意向。 此成员可以是以下预定义值之一，或者驱动程序定义的值大于或等于DMICM_USER的值。

dmMediaType

指定要打印的介质的类型。 该成员可以是以下预定义值之一，也可以是大于或等于DMMEDIA_USER值的驱动程序定义值。

若要检索打印机可用媒体类型的列表，请使用具有DC_MEDIATYPES标志的 DeviceCapabilities 函数。

dmDitherType

指定如何执行任用。 该成员可以是以下预定义值之一，也可以是大于或等于DMDITHER_USER值的驱动程序定义值之一。

dmReserved1

未使用;必须为零。

dmReserved2

未使用;必须为零。

dmPanningWidth

此成员必须为零。

dmPanningHeight

此成员必须为零。

言论

设备驱动程序的专用数据遵循 DEVMODE 结构的公共部分。 公共数据的大小可能因结构的不同版本而异。 dmSize 成员指定公共数据的字节数，dmDriverExtra 成员指定专用数据的字节数。

要求

另请参阅

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

DocumentProperties

EnumDisplaySettings

OpenPrinter

打印后台处理程序 API 结构

打印