Estructura DEVMODEA (wingdi.h)

La estructura de datos DEVMODE contiene información sobre la inicialización y el entorno de una impresora o un dispositivo de visualización.

Sintaxis

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;

Miembros

dmDeviceName[CCHDEVICENAME]

Matriz de caracteres terminada en cero que especifica el nombre "descriptivo" de la impresora o pantalla; por ejemplo, "PCL/HP LaserJet" en el caso de PCL/HP LaserJet. Esta cadena es única entre los controladores de dispositivo. Tenga en cuenta que este nombre puede truncarse para caber en la matriz dmDeviceName .

dmSpecVersion

Número de versión de la especificación de datos de inicialización en la que se basa la estructura. Para asegurarse de que se usa la versión correcta para cualquier sistema operativo, use DM_SPECVERSION.

dmDriverVersion

Número de versión del controlador asignado por el desarrollador del controlador.

dmSize

Especifica el tamaño, en bytes, de la estructura DEVMODE , sin incluir ningún dato específico del controlador privado que pueda seguir a los miembros públicos de la estructura. Establezca este miembro sizeof (DEVMODE) en para indicar la versión de la estructura DEVMODE que se está usando.

dmDriverExtra

Contiene el número de bytes de datos de controladores privados que siguen esta estructura. Si un controlador de dispositivo no usa información específica del dispositivo, establezca este miembro en cero.

dmFields

Especifica si se han inicializado determinados miembros de la estructura DEVMODE . Si se inicializa un miembro, se establece su bit correspondiente; de lo contrario, el bit está claro. Un controlador solo admite los miembros DEVMODE que son adecuados para la tecnología de impresora o pantalla.

Se definen los siguientes valores y se enumeran aquí con los miembros de estructura correspondientes.

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmOrientation

Solo para dispositivos de impresora, selecciona la orientación del papel. Este miembro puede ser DMORIENT_PORTRAIT (1) o DMORIENT_LANDSCAPE (2).

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

Solo para los dispositivos de impresora, selecciona el tamaño del papel en el que se va a imprimir. Este miembro se puede establecer en cero si los miembros dmPaperLength y dmPaperWidth establecen la longitud y el ancho del papel. De lo contrario, el miembro dmPaperSize se puede establecer en un valor específico del dispositivo mayor o igual que DMPAPER_USER o en uno de los siguientes valores predefinidos.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength

Solo para dispositivos de impresora, invalida la longitud del papel especificado por el miembro dmPaperSize , ya sea para tamaños de papel personalizados o para dispositivos como impresoras de matriz de puntos que pueden imprimir en una página de longitud arbitraria. Estos valores, junto con todos los demás valores de esta estructura que especifican una longitud física, están en décimas de milímetros.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth

Solo para dispositivos de impresora, invalida el ancho del papel especificado por el miembro dmPaperSize .

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale

Especifica el factor por el que se va a escalar la salida impresa. El tamaño de página aparente se escala desde el tamaño de página físico por un factor de dmScale /100. Por ejemplo, una página de tamaño de letra con un valor dmScale de 50 contendrá tantos datos como una página de 17 a 22 pulgadas porque el texto de salida y los gráficos serían la mitad de su alto y ancho originales.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies

Selecciona el número de copias impresas si el dispositivo admite copias de varias páginas.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource

Especifica el origen del papel. Para recuperar una lista de los orígenes de papel disponibles para una impresora, use la función DeviceCapabilities con la marca DC_BINS.

Este miembro puede ser uno de los valores siguientes o puede ser un valor específico del dispositivo mayor o igual que DMBIN_USER.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality

Especifica la resolución de la impresora. Hay cuatro valores predefinidos independientes del dispositivo:

Si se especifica un valor positivo, especifica el número de puntos por pulgada (PPP) y, por tanto, depende del dispositivo.

DUMMYUNIONNAME.dmPosition

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition

Solo para dispositivos de visualización, una estructura POINTL que indica las coordenadas posicionales del dispositivo de visualización en referencia al área de escritorio. El dispositivo de visualización principal siempre se encuentra en coordenadas (0,0).

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation

Solo para dispositivos de visualización, la orientación en la que se deben presentar las imágenes. Si no se establece DM_DISPLAYORIENTATION, este miembro debe ser cero. Si se establece DM_DISPLAYORIENTATION, este miembro debe ser uno de los siguientes valores.

Para determinar si la orientación de la pantalla es vertical o horizontal, compruebe la relación de dmPelsWidth con dmPelsHeight.

Windows 2000: No se admite.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

Solo para dispositivos de pantalla de resolución fija, la forma en que la pantalla presenta un modo de baja resolución en una pantalla de mayor resolución. Por ejemplo, si la resolución de un dispositivo de pantalla se fija en 1024 x 768 píxeles, pero su modo está establecido en 640 x 480 píxeles, el dispositivo puede mostrar una imagen de 640 x 480 en algún lugar del interior del espacio de pantalla 1024 x 768 o estirar la imagen de 640 x 480 para rellenar el espacio de pantalla más grande. Si no se establece DM_DISPLAYFIXEDOUTPUT, este miembro debe ser cero. Si se establece DM_DISPLAYFIXEDOUTPUT, este miembro debe ser uno de los valores siguientes.

Windows 2000: No se admite.

dmColor

Cambia entre color y monocromo en impresoras de color. Los posibles valores son los siguientes:

• DMCOLOR_COLOR
• DMCOLOR_MONOCHROME

dmDuplex

Selecciona impresión dúplex o de doble cara para impresoras capaces de imprimir dúplex. A continuación se muestran los valores posibles.

dmYResolution

Especifica la resolución y, en puntos por pulgada, de la impresora. Si la impresora inicializa este miembro, el miembro dmPrintQuality especifica la resolución x, en puntos por pulgada, de la impresora.

dmTTOption

Especifica cómo se deben imprimir las fuentes TrueType. Este miembro puede ser uno de los valores siguientes.

dmCollate

Especifica si se debe usar la intercalación al imprimir varias copias. (Este miembro se omite a menos que el controlador de impresora indique la compatibilidad con la intercalación estableciendo el miembro dmFields en DM_COLLATE). Este miembro puede ser uno de los valores siguientes.

dmFormName[CCHFORMNAME]

Matriz de caracteres terminada en cero que especifica el nombre del formulario que se va a utilizar; por ejemplo, "Carta" o "Legal". Se puede recuperar un conjunto completo de nombres mediante la función EnumForms .

dmLogPixels

Número de píxeles por pulgada lógica. Los controladores de impresora no usan este miembro.

dmBitsPerPel

Especifica la resolución de color, en bits por píxel, del dispositivo de visualización (por ejemplo: 4 bits para 16 colores, 8 bits para 256 colores o 16 bits para 65 536 colores). Los controladores de pantalla usan este miembro, por ejemplo, en la función ChangeDisplaySettings . Los controladores de impresora no usan este miembro.

dmPelsWidth

Especifica el ancho, en píxeles, de la superficie del dispositivo visible. Los controladores de pantalla usan este miembro, por ejemplo, en la función ChangeDisplaySettings . Los controladores de impresora no usan este miembro.

dmPelsHeight

Especifica el alto, en píxeles, de la superficie del dispositivo visible. Los controladores de pantalla usan este miembro, por ejemplo, en la función ChangeDisplaySettings . Los controladores de impresora no usan este miembro.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.dmDisplayFlags

Especifica el modo de presentación del dispositivo. Este miembro puede ser una combinación de los valores siguientes.

Los controladores de pantalla usan este miembro, por ejemplo, en la función ChangeDisplaySettings . Los controladores de impresora no usan este miembro.

DUMMYUNIONNAME2.dmNup

Especifica dónde se realiza el NUP. Puede ser uno de los siguientes.

dmDisplayFrequency

Especifica la frecuencia, en hercios (ciclos por segundo), del dispositivo de visualización en un modo determinado. Este valor también se conoce como la frecuencia de actualización vertical del dispositivo de pantalla. Los controladores de pantalla usan este miembro. Se usa, por ejemplo, en la función ChangeDisplaySettings . Los controladores de impresora no usan este miembro.

Al llamar a la función EnumDisplaySettings , el miembro dmDisplayFrequency puede devolver con el valor 0 o 1. Estos valores representan la frecuencia de actualización predeterminada del hardware de visualización. Esta velocidad predeterminada se establece normalmente mediante conmutadores en una tarjeta de pantalla o una placa base del equipo, o por un programa de configuración que no usa funciones de visualización como ChangeDisplaySettings.

dmICMMethod

Especifica cómo se controla ICM. En el caso de una aplicación que no es ICM, este miembro determina si ICM está habilitado o deshabilitado. En el caso de las aplicaciones ICM, el sistema examina este miembro para determinar cómo controlar la compatibilidad con ICM. Este miembro puede ser uno de los siguientes valores predefinidos o un valor definido por el controlador mayor o igual que el valor de DMICMMETHOD_USER.

El controlador de impresora debe proporcionar una interfaz de usuario para establecer este miembro. La mayoría de los controladores de impresora solo admiten el valor de DMICMMETHOD_SYSTEM o DMICMMETHOD_NONE. Los controladores para impresoras PostScript admiten todos los valores.

dmICMIntent

Especifica qué método de coincidencia de colores, o intención, se deben usar de forma predeterminada. Este miembro es principalmente para aplicaciones que no son ICM. Las aplicaciones ICM pueden establecer intenciones mediante las funciones ICM. Este miembro puede ser uno de los siguientes valores predefinidos o un valor definido por el controlador mayor o igual que el valor de DMICM_USER.

dmMediaType

Especifica el tipo de medio en el que se imprime. El miembro puede ser uno de los siguientes valores predefinidos o un valor definido por el controlador mayor o igual que el valor de DMMEDIA_USER.

Para recuperar una lista de los tipos de medios disponibles para una impresora, use la función DeviceCapabilities con la marca DC_MEDIATYPES.

dmDitherType

Especifica cómo se va a realizar el dithering. El miembro puede ser uno de los siguientes valores predefinidos o un valor definido por el controlador mayor o igual que el valor de DMDITHER_USER.

dmReserved1

No se usa; debe ser cero.

dmReserved2

No se usa; debe ser cero.

dmPanningWidth

Este miembro debe ser cero.

dmPanningHeight

Este miembro debe ser cero.

Comentarios

Los datos privados de un controlador de dispositivo siguen la parte pública de la estructura DEVMODE . El tamaño de los datos públicos puede variar para diferentes versiones de la estructura. El miembro dmSize especifica el número de bytes de datos públicos y el miembro dmDriverExtra especifica el número de bytes de datos privados.

Requisitos

Consulte también

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

Documentproperties

EnumDisplaySettings

OpenPrinter

Imprimir estructuras de API de Spooler

Impresión