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.
| Valor | Miembro de estructura |
|---|---|
| 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 | dmPanningWidth |
| DM_PANNINGHEIGHT | dmPanningHeight |
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.
| Valor | Significado |
|---|---|
| DMPAPER_LETTER | Carta, 8 1/2- por 11 pulgadas |
| DMPAPER_LEGAL | Legal, 8 1/2- por 14 pulgadas |
| DMPAPER_9X11 | Hoja de 9 a 11 pulgadas |
| DMPAPER_10X11 | Hoja de 10 a 11 pulgadas |
| DMPAPER_10X14 | Hoja de 10 por 14 pulgadas |
| DMPAPER_15X11 | Hoja de 15 a 11 pulgadas |
| DMPAPER_11X17 | Hoja de 11 a 17 pulgadas |
| DMPAPER_12X11 | Hoja de 12 a 11 pulgadas |
| DMPAPER_A2 | Hoja A2, 420 x 594 milímetros |
| DMPAPER_A3 | Hoja A3, 297- por 420 milímetros |
| DMPAPER_A3_EXTRA | A3 Extra 322 x 445 milímetros |
| DMPAPER_A3_EXTRA_TRAVERSE | A3 Extra Transversal 322 x 445 milímetros |
| DMPAPER_A3_ROTATED | Hoja girada A3, 420- por 297 milímetros |
| DMPAPER_A3_TRAVERSE | A3 Transverse 297 x 420 milímetros |
| DMPAPER_A4 | Hoja A4, 210- por 297 milímetros |
| DMPAPER_A4_EXTRA | Hoja A4, 9,27 x 12,69 pulgadas |
| DMPAPER_A4_PLUS | A4 Plus 210 x 330 milímetros |
| DMPAPER_A4_ROTATED | Hoja girada A4, 297- por 210 milímetros |
| DMPAPER_A4SMALL | Hoja pequeña A4, 210- por 297 milímetros |
| DMPAPER_A4_TRANSVERSE | A4 Transverse 210 x 297 milímetros |
| DMPAPER_A5 | Hoja A5, 148- por 210 milímetros |
| DMPAPER_A5_EXTRA | A5 Extra 174 x 235 milímetros |
| DMPAPER_A5_ROTATED | Hoja girada A5, 210- por 148 milímetros |
| DMPAPER_A5_TRANSVERSE | A5 Transverse 148 x 210 milímetros |
| DMPAPER_A6 | Hoja A6, 105- por 148 milímetros |
| DMPAPER_A6_ROTATED | Hoja girada A6, 148- por 105 milímetros |
| DMPAPER_A_PLUS | SuperA/A4 227 x 356 -milímetros |
| DMPAPER_B4 | Hoja B4, 250- por 354 milímetros |
| DMPAPER_B4_JIS_ROTATED | B4 (JIS) hoja girada, 364- por 257 milímetros |
| DMPAPER_B5 | Hoja B5, papel de 182- por 257 milímetros |
| DMPAPER_B5_EXTRA | B5 (ISO) Extra 201 x 276 milímetros |
| DMPAPER_B5_JIS_ROTATED | B5 (JIS) hoja girada, 257- por 182 milímetros |
| DMPAPER_B6_JIS | Hoja B6 (JIS), 128- por 182 milímetros |
| DMPAPER_B6_JIS_ROTATED | B6 (JIS) hoja girada, 182- por 128 milímetros |
| DMPAPER_B_PLUS | SuperB/A3 305 x 487-milímetros |
| DMPAPER_CSHEET | Hoja C, de 17 a 22 pulgadas |
| DMPAPER_DBL_JAPANESE_POSTCARD | Postal japonesa doble, 200- por 148 milímetros |
| DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED | Postal japonesa doble girada, 148- por 200 milímetros |
| DMPAPER_DSHEET | Hoja D, de 22 a 34 pulgadas |
| DMPAPER_ENV_9 | #9 Sobre, 3 7/8- por 8 7/8 pulgadas |
| DMPAPER_ENV_10 | #10 Sobre, 4 1/8- por 9 1/2 pulgadas |
| DMPAPER_ENV_11 | #11 Sobre, 4 1/2- por 10 3/8 pulgadas |
| DMPAPER_ENV_12 | #12 Sobre, 4 3/4- por 11 pulgadas |
| DMPAPER_ENV_14 | #14 Sobre, de 5 a 11 1/2 pulgadas |
| DMPAPER_ENV_C5 | Sobre C5, 162- por 229 milímetros |
| DMPAPER_ENV_C3 | Sobre C3, 324- por 458 milímetros |
| DMPAPER_ENV_C4 | Sobre C4, 229- por 324 milímetros |
| DMPAPER_ENV_C6 | Sobre C6, 114- por 162 milímetros |
| DMPAPER_ENV_C65 | Sobre C65, 114- por 229 milímetros |
| DMPAPER_ENV_B4 | Sobre B4, 250- por 353 milímetros |
| DMPAPER_ENV_B5 | B5 Envelope, 176- por 250 milímetros |
| DMPAPER_ENV_B6 | Sobre B6, 176- por 125 milímetros |
| DMPAPER_ENV_DL | Sobre DL, 110- por 220 milímetros |
| DMPAPER_ENV_INVITE | Invitación de sobre 220 x 220 mm |
| DMPAPER_ENV_ITALY | Sobre Italia, 110- por 230 milímetros |
| DMPAPER_ENV_MONARCH | Sobre del rey, 3 7/8- por 7 1/2 pulgadas |
| DMPAPER_ENV_PERSONAL | Sobre de 6 3/4, 3 5/8- por 6 1/2 pulgadas |
| DMPAPER_ESHEET | Hoja E, de 34 a 44 pulgadas |
| DMPAPER_EXECUTIVE | Ejecutivo, 7 1/4- por 10 1/2 pulgadas |
| DMPAPER_FANFOLD_US | Us Std Fanfold, 14 7/8- por 11 pulgadas |
| DMPAPER_FANFOLD_STD_GERMAN | Fanfold alemán std, 8 1/2- por 12 pulgadas |
| DMPAPER_FANFOLD_LGL_GERMAN | Ventilador legal alemán, de 8 a 13 pulgadas |
| DMPAPER_FOLIO | Folio, 8 1/2- por papel de 13 pulgadas |
| DMPAPER_ISO_B4 | B4 (ISO) 250- por papel de 353 milímetros |
| DMPAPER_JAPANESE_POSTCARD | Postal japonesa, 100- por 148 milímetros |
| DMPAPER_JAPANESE_POSTCARD_ROTATED | Postal japonesa girada, 148- por 100 milímetros |
| DMPAPER_JENV_CHOU3 | Sobre japonés Chou #3 |
| DMPAPER_JENV_CHOU3_ROTATED | Sobre japonés Chou #3 Girado |
| DMPAPER_JENV_CHOU4 | Sobre japonés Chou #4 |
| DMPAPER_JENV_CHOU4_ROTATED | Sobre japonés Chou #4 Girado |
| DMPAPER_JENV_KAKU2 | Sobre japonés Kaku n.º 2 |
| DMPAPER_JENV_KAKU2_ROTATED | Sobre japonés Kaku n.º 2 girado |
| DMPAPER_JENV_KAKU3 | Sobre japonés Kaku n.º 3 |
| DMPAPER_JENV_KAKU3_ROTATED | Sobre japonés Kaku n.º 3 girado |
| DMPAPER_JENV_YOU4 | Sobre japonés #4 |
| DMPAPER_JENV_YOU4_ROTATED | Sobre japonés girado n.º 4 |
| DMPAPER_LAST | DMPAPER_PENV_10_ROTATED |
| DMPAPER_LEDGER | Libro de contabilidad, de 17 a 11 pulgadas |
| DMPAPER_LEGAL_EXTRA | Extra legal 9 1/2 x 15 pulgadas. |
| DMPAPER_LETTER_EXTRA | Letra Extra 9 1/2 x 12 pulgadas. |
| DMPAPER_LETTER_EXTRA_TRANSVERSE | Letra Extra transversal 9 1/2 x 12 pulgadas. |
| DMPAPER_LETTER_ROTATED | Letra girada 11 por 8 1/2 pulgadas |
| DMPAPER_LETTERSMALL | Letra pequeña, 8 1/2- por 11 pulgadas |
| DMPAPER_LETTER_TRANSVERSE | Letra transversal 8 1/2 x 11 pulgadas |
| DMPAPER_NOTE | Nota: 8 1/2- por 11 pulgadas |
| DMPAPER_P16K | PRC 16K, 146- por 215 milímetros |
| DMPAPER_P16K_ROTATED | PRC 16K Girado, 215- por 146 milímetros |
| DMPAPER_P32K | PRC 32K, 97- por 151-milímetros |
| DMPAPER_P32K_ROTATED | PRC 32K Girado, 151- por 97 milímetros |
| DMPAPER_P32KBIG | PRC 32K(Big) 97- por 151-milímetros |
| DMPAPER_P32KBIG_ROTATED | PRC 32K(Big) Girado, 151- por 97 milímetros |
| DMPAPER_PENV_1 | Sobre PRC n.º 1, 102- por 165 milímetros |
| DMPAPER_PENV_1_ROTATED | Sobre PRC #1 Girado, 165- por 102-milímetros |
| DMPAPER_PENV_2 | Sobre PRC #2, 102- por 176 milímetros |
| DMPAPER_PENV_2_ROTATED | Sobre PRC #2 Girado, 176- por 102 milímetros |
| DMPAPER_PENV_3 | Sobre PRC n.º 3, 125- por 176 milímetros |
| DMPAPER_PENV_3_ROTATED | Sobre PRC #3 Girado, 176- por 125 milímetros |
| DMPAPER_PENV_4 | Sobre PRC n.º 4, 110- por 208 milímetros |
| DMPAPER_PENV_4_ROTATED | Sobre PRC #4 Girado, 208- por 110 milímetros |
| DMPAPER_PENV_5 | Sobre PRC #5, 110- por 220 milímetros |
| DMPAPER_PENV_5_ROTATED | Sobre PRC #5 Girado, 220- por 110 milímetros |
| DMPAPER_PENV_6 | Sobre PRC n.º 6, 120- por 230 milímetros |
| DMPAPER_PENV_6_ROTATED | Sobre PRC #6 Girado, 230- por 120 milímetros |
| DMPAPER_PENV_7 | Sobre PRC n.º 7, 160- por 230 milímetros |
| DMPAPER_PENV_7_ROTATED | Sobre PRC #7 Girado, 230- por 160 milímetros |
| DMPAPER_PENV_8 | Sobre PRC n.º 8, 120- por 309 milímetros |
| DMPAPER_PENV_8_ROTATED | Sobre PRC #8 Girado, 309- por 120 milímetros |
| DMPAPER_PENV_9 | Sobre PRC n.º 9, 229- por 324 milímetros |
| DMPAPER_PENV_9_ROTATED | Sobre PRC #9 Girado, 324- por 229 milímetros |
| DMPAPER_PENV_10 | Sobre PRC #10, 324- por 458 milímetros |
| DMPAPER_PENV_10_ROTATED | Sobre PRC #10 Girado, 458- por 324 milímetros |
| DMPAPER_QUARTO | Quarto, 215- por 275 milímetros papel |
| DMPAPER_STATEMENT | Declaración, 5 1/2- por 8 1/2 pulgadas |
| DMPAPER_TABLOID | Tabloid, de 11 a 17 pulgadas |
| DMPAPER_TABLOID_EXTRA | Tabloid, 11,69 x 18 pulgadas |
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.
| Valor | Significado |
|---|---|
| DMDO_DEFAULT | La orientación de la pantalla es la orientación natural del dispositivo de pantalla; se debe usar como valor predeterminado. |
| DMDO_90 | La orientación de la pantalla gira 90 grados (medida en el sentido de las agujas del reloj) de DMDO_DEFAULT. |
| DMDO_180 | La orientación de la pantalla gira 180 grados (medida en el sentido de las agujas del reloj) de DMDO_DEFAULT. |
| DMDO_270 | La orientación de la pantalla gira 270 grados (medida en el sentido de las agujas del reloj) de DMDO_DEFAULT. |
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.
| Valor | Significado |
|---|---|
| DMDFO_DEFAULT | Configuración predeterminada de la pantalla. |
| DMDFO_CENTER | La imagen de baja resolución se centra en el espacio de pantalla más grande. |
| DMDFO_STRETCH | La imagen de baja resolución se extiende para rellenar el espacio de pantalla más grande. |
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.
| Valor | Significado |
|---|---|
| DMDUP_SIMPLEX | Impresión normal (noduplex). |
| DMDUP_HORIZONTAL | Enlace de borde corto, es decir, el borde largo de la página es horizontal. |
| DMDUP_VERTICAL | El enlace de borde largo, es decir, el borde largo de la página es vertical. |
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.
| Valor | Significado |
|---|---|
| DMTT_BITMAP | Imprime fuentes TrueType como gráficos. Esta es la acción predeterminada para las impresoras de matriz de puntos. |
| DMTT_DOWNLOAD | Descarga fuentes TrueType como fuentes suaves. Esta es la acción predeterminada para Hewlett-Packard impresoras que usan lenguaje de control de impresora (PCL). |
| DMTT_DOWNLOAD_OUTLINE | Descarga fuentes TrueType como fuentes suaves de esquema. |
| DMTT_SUBDEV | Sustituye las fuentes del dispositivo por las fuentes TrueType. Esta es la acción predeterminada para las impresoras PostScript. |
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.
| Valor | Significado |
|---|---|
| DMCOLLATE_TRUE | Intercalar al imprimir varias copias. |
| DMCOLLATE_FALSE | No intercale al imprimir varias copias. |
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.
| Valor | Significado |
|---|---|
| DM_GRAYSCALE | Especifica que la pantalla es un dispositivo que no es de color. Si no se establece esta marca, se asume el color. Esta marca ya no es válida. |
| DM_INTERLACED | Especifica que el modo de presentación está entrelazado. Si no se establece la marca, se supone que no se interlaza. |
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.
| Valor | Significado |
|---|---|
| DMNUP_SYSTEM | El administrador de trabajos de impresión realiza el NUP. |
| DMNUP_ONEUP | La aplicación realiza el NUP. |
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.
| Valor | Significado |
|---|---|
| DMICMMETHOD_NONE | Especifica que ICM está deshabilitado. |
| DMICMMETHOD_SYSTEM | Especifica que Windows controla ICM. |
| DMICMMETHOD_DRIVER | Especifica que el controlador del dispositivo controla ICM. |
| DMICMMETHOD_DEVICE | Especifica que el dispositivo de destino controla ICM. |
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.
| Valor | Significado |
|---|---|
| DMICM_ABS_COLORIMETRIC | La coincidencia de colores debe optimizarse para que coincida con el color exacto solicitado sin asignación de puntos blancos. Este valor es más adecuado para su uso con corrección. |
| DMICM_COLORIMETRIC | La coincidencia de colores debe optimizarse para que coincida con el color exacto solicitado. Este valor es más adecuado para su uso con logotipos empresariales u otras imágenes cuando se desea una coincidencia de color exacta. |
| DMICM_CONTRAST | La coincidencia de colores debe optimizarse para el contraste de color. Este valor es la opción más adecuada para imágenes escaneadas o fotográficas cuando se desea la dithering. |
| DMICM_SATURATE | La coincidencia de colores debe optimizarse para la saturación del color. Este valor es la opción más adecuada para los gráficos empresariales cuando no se desea la dithering. |
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.
| Valor | Significado |
|---|---|
| DMMEDIA_STANDARD | Papel normal. |
| DMMEDIA_GLOSSY | Papel brillante. |
| DMMEDIA_TRANSPARENCY | Película transparente. |
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.
| Valor | Significado |
|---|---|
| DMDITHER_NONE | No hay atesos. |
| DMDITHER_COARSE | Dithering con un pincel grueso. |
| DMDITHER_FINE | Dithering con un pincel fino. |
| DMDITHER_LINEART | Dithering de arte de líneas, un método especial de dithering que produce bordes bien definidos entre el escalado negro, blanco y gris. No es adecuado para imágenes que incluyan graduaciones continuas en intensidad y tono, como fotografías escaneadas. |
| DMDITHER_GRAYSCALE | El dispositivo realiza un escalado gris. |
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.
Nota
El encabezado wingdi.h define DEVMODE como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | wingdi.h (incluye Windows.h) |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de