Struttura DEVMODEA (wingdi.h)

La struttura dei dati DEVMODE contiene informazioni sull'inizializzazione e sull'ambiente di una stampante o di un dispositivo di visualizzazione.

Sintassi

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;

Members

dmDeviceName[CCHDEVICENAME]

Matrice di caratteri con terminazione zero che specifica il nome "descrittivo" della stampante o della visualizzazione; Ad esempio, "PCL/HP LaserJet" nel caso di PCL/HP LaserJet. Questa stringa è univoca tra i driver di dispositivo. Si noti che questo nome può essere troncato per adattarsi alla matrice dmDeviceName .

dmSpecVersion

Numero di versione della specifica dei dati di inizializzazione su cui si basa la struttura. Per assicurarsi che la versione corretta venga usata per qualsiasi sistema operativo, usare DM_SPECVERSION.

dmDriverVersion

Numero di versione del driver assegnato dallo sviluppatore del driver.

dmSize

Specifica le dimensioni, in byte, della struttura DEVMODE , senza includere dati specifici del driver privato che potrebbero seguire i membri pubblici della struttura. Impostare questo membro su sizeof (DEVMODE) per indicare la versione della struttura DEVMODE in uso.

dmDriverExtra

Contiene il numero di byte di dati del driver privato che seguono questa struttura. Se un driver di dispositivo non usa informazioni specifiche del dispositivo, impostare questo membro su zero.

dmFields

Specifica se alcuni membri della struttura DEVMODE sono stati inizializzati. Se un membro viene inizializzato, viene impostato il bit corrispondente; in caso contrario, il bit è chiaro. Un driver supporta solo i membri DEVMODE appropriati per la stampante o la tecnologia di visualizzazione.

I valori seguenti sono definiti e sono elencati qui con i membri della struttura corrispondenti.

Valore Membro struttura
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 per i dispositivi della stampante, seleziona l'orientamento della carta. Questo membro può essere DMORIENT_PORTRAIT (1) o DMORIENT_LANDSCAPE (2).

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperSize

Solo per i dispositivi della stampante, seleziona le dimensioni della carta su cui stampare. Questo membro può essere impostato su zero se la lunghezza e la larghezza del foglio sono entrambe impostate dai membri dmPaperLength e dmPaperWidth . In caso contrario, il membro dmPaperSize può essere impostato su un valore specifico del dispositivo maggiore o uguale a DMPAPER_USER o a uno dei valori predefiniti seguenti.

Valore Significato
DMPAPER_LETTER Lettera, 8 1/2- 11 pollici
DMPAPER_LEGAL Legale, 8 1/2- 14 pollici
DMPAPER_9X11 Foglio da 9 a 11 pollici
DMPAPER_10X11 Foglio da 10 a 11 pollici
DMPAPER_10X14 Foglio da 10 a 14 pollici
DMPAPER_15X11 Foglio da 15 a 11 pollici
DMPAPER_11X17 Foglio da 11 a 17 pollici
DMPAPER_12X11 Foglio da 12 a 11 pollici
DMPAPER_A2 Foglio A2, 420 x 594 millimetri
DMPAPER_A3 Foglio A3, da 297 a 420 millimetri
DMPAPER_A3_EXTRA A3 Extra 322 x 445 millimetri
DMPAPER_A3_EXTRA_TRAVERSE A3 Extra Transverse 322 x 445 millimetri
DMPAPER_A3_ROTATED A3 foglio ruotato, 420- per 297 millimetri
DMPAPER_A3_TRAVERSE A3 Transverse 297 x 420 millimetri
DMPAPER_A4 Foglio A4, da 210 a 297 millimetri
DMPAPER_A4_EXTRA Foglio A4, 9,27 x 12,69 pollici
DMPAPER_A4_PLUS A4 Plus 210 x 330 millimetri
DMPAPER_A4_ROTATED A4 foglio ruotato, 297- per 210 millimetri
DMPAPER_A4SMALL A4 piccolo foglio, 210- da 297 millimetri
DMPAPER_A4_TRANSVERSE A4 Transverse 210 x 297 millimetri
DMPAPER_A5 Foglio A5, 148- per 210 millimetri
DMPAPER_A5_EXTRA A5 Extra 174 x 235 millimetri
DMPAPER_A5_ROTATED A5 foglio ruotato, 210- per 148 millimetri
DMPAPER_A5_TRANSVERSE A5 Transverse 148 x 210 millimetri
DMPAPER_A6 Foglio A6, da 105 a 148 millimetri
DMPAPER_A6_ROTATED Foglio ruotato A6, 148- da 105 millimetri
DMPAPER_A_PLUS SuperA/A4 227 x 356 millimetri
DMPAPER_B4 Foglio B4, da 250 a 354 millimetri
DMPAPER_B4_JIS_ROTATED Foglio ruotato B4 (JIS), 364- per 257 millimetri
DMPAPER_B5 Foglio B5, carta da 182 a 257 millimetri
DMPAPER_B5_EXTRA B5 (ISO) Extra 201 x 276 millimetri
DMPAPER_B5_JIS_ROTATED Foglio ruotato B5 (JIS), 257- da 182 millimetri
DMPAPER_B6_JIS Foglio B6 (JIS), 128- da 182 millimetri
DMPAPER_B6_JIS_ROTATED Foglio ruotato B6 (JIS), 182- per 128 millimetri
DMPAPER_B_PLUS SuperB/A3 305 x 487 millimetri
DMPAPER_CSHEET Foglio C, da 17 a 22 pollici
DMPAPER_DBL_JAPANESE_POSTCARD Cartolina giapponese doppia, da 200 a 148 millimetri
DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED Doppia cartolina giapponese ruotata, 148- di 200 millimetri
DMPAPER_DSHEET D Foglio, da 22 a 34 pollici
DMPAPER_ENV_9 Busta n. 9, 3 7/8- per 8 7/8 pollici
DMPAPER_ENV_10 Busta #10, 4 1/8- 9 1/2 pollici
DMPAPER_ENV_11 Busta n. 11, 4 1/2- 10 3/8 pollici
DMPAPER_ENV_12 Busta n. 12, 4 3/4 per 11 pollici
DMPAPER_ENV_14 Busta n. 14, da 5 a 11 1/2 pollici
DMPAPER_ENV_C5 Busta C5, da 162 a 229 millimetri
DMPAPER_ENV_C3 Busta C3, da 324 a 458 millimetri
DMPAPER_ENV_C4 Busta C4, 229- per 324 millimetri
DMPAPER_ENV_C6 Busta C6, da 114 a 162 millimetri
DMPAPER_ENV_C65 Busta C65, da 114 a 229 millimetri
DMPAPER_ENV_B4 Busta B4, da 250 a 353 millimetri
DMPAPER_ENV_B5 Busta B5, da 176 a 250 millimetri
DMPAPER_ENV_B6 Busta B6, 176- da 125 millimetri
DMPAPER_ENV_DL Busta DL, 110- per 220 millimetri
DMPAPER_ENV_INVITE Invito busta 220 x 220 mm
DMPAPER_ENV_ITALY Busta Italia, 110- per 230 millimetri
DMPAPER_ENV_MONARCH Busta monarcha, 3 7/8 per 7 1/2 pollici
DMPAPER_ENV_PERSONAL 6 3/4 Busta, 3 5/8 per 6 1/2 pollici
DMPAPER_ESHEET Foglio E, 34- da 44 pollici
DMPAPER_EXECUTIVE Executive, 7 1/4- da 10 1/2 pollici
DMPAPER_FANFOLD_US Us Std Fanfold, 14 7/8 per 11 pollici
DMPAPER_FANFOLD_STD_GERMAN Fanfold tedesco Std, 8 1/2- da 12 pollici
DMPAPER_FANFOLD_LGL_GERMAN Fanfold legale tedesco, 8 - da 13 pollici
DMPAPER_FOLIO Folio, 8 1/2- da 13 pollici
DMPAPER_ISO_B4 B4 (ISO) da 250 a 353 millimetri di carta
DMPAPER_JAPANESE_POSTCARD Cartolina giapponese, da 100 a 148 millimetri
DMPAPER_JAPANESE_POSTCARD_ROTATED Cartolina giapponese ruotata, da 148 a 100 millimetri
DMPAPER_JENV_CHOU3 Busta giapponese Chou #3
DMPAPER_JENV_CHOU3_ROTATED Busta giapponese Chou #3 Ruotata
DMPAPER_JENV_CHOU4 Busta giapponese Chou #4
DMPAPER_JENV_CHOU4_ROTATED Busta giapponese Chou #4 Ruotata
DMPAPER_JENV_KAKU2 Busta giapponese Kaku #2
DMPAPER_JENV_KAKU2_ROTATED Busta giapponese Kaku #2 Ruotata
DMPAPER_JENV_KAKU3 Busta giapponese Kaku #3
DMPAPER_JENV_KAKU3_ROTATED Busta giapponese Kaku #3 Ruotata
DMPAPER_JENV_YOU4 Busta giapponese #4
DMPAPER_JENV_YOU4_ROTATED Busta giapponese 4 ruotata
DMPAPER_LAST DMPAPER_PENV_10_ROTATED
DMPAPER_LEDGER Ledger, 17- da 11 pollici
DMPAPER_LEGAL_EXTRA Legale Extra 9 1/2 x 15 pollici.
DMPAPER_LETTER_EXTRA Lettera Extra 9 1/2 x 12 pollici.
DMPAPER_LETTER_EXTRA_TRANSVERSE Lettera Extra Transverse 9 1/2 x 12 pollici.
DMPAPER_LETTER_ROTATED Lettera ruotata da 11 a 8 1/2 pollici
DMPAPER_LETTERSMALL Lettera piccola, 8 1/2- per 11 pollici
DMPAPER_LETTER_TRANSVERSE Lettera trasversa 8 1/2 x 11 pollici
DMPAPER_NOTE Nota, da 8 1/2 a 11 pollici
DMPAPER_P16K PRC 16K, 146- da 215 millimetri
DMPAPER_P16K_ROTATED PRC 16K Ruotato, 215- da 146 millimetri
DMPAPER_P32K PRC 32K, 97 per 151 millimetri
DMPAPER_P32K_ROTATED PRC 32K Ruotato, 151- per 97 millimetri
DMPAPER_P32KBIG PRC 32K(Big) 97- da 151 millimetri
DMPAPER_P32KBIG_ROTATED PRC 32K(Big) Ruotato, 151- da 97 millimetri
DMPAPER_PENV_1 Busta PRC #1, 102- per 165 millimetri
DMPAPER_PENV_1_ROTATED Busta PRC #1 Ruotata, 165- per 102 millimetri
DMPAPER_PENV_2 Busta PRC #2, 102- per 176 millimetri
DMPAPER_PENV_2_ROTATED Busta PRC #2 Ruotata, 176- da 102 millimetri
DMPAPER_PENV_3 Busta PRC #3, 125- per 176 millimetri
DMPAPER_PENV_3_ROTATED Busta PRC #3 Ruotata, 176- da 125 millimetri
DMPAPER_PENV_4 Busta PRC #4, 110- da 208 millimetri
DMPAPER_PENV_4_ROTATED Busta PRC #4 Ruotata, 208- da 110 millimetri
DMPAPER_PENV_5 Busta PRC #5, 110- per 220 millimetri
DMPAPER_PENV_5_ROTATED Busta PRC #5 Ruotata, 220- per 110 millimetri
DMPAPER_PENV_6 Busta PRC #6, 120- per 230 millimetri
DMPAPER_PENV_6_ROTATED Busta PRC #6 Ruotata, 230- per 120 millimetri
DMPAPER_PENV_7 Busta PRC #7, 160- per 230 millimetri
DMPAPER_PENV_7_ROTATED Busta PRC #7 Ruotata, 230- per 160 millimetri
DMPAPER_PENV_8 Busta PRC n. 8, da 120 a 309 millimetri
DMPAPER_PENV_8_ROTATED Busta PRC n. 8 ruotata, 309- di 120 millimetri
DMPAPER_PENV_9 Busta PRC 9, 229- per 324 millimetri
DMPAPER_PENV_9_ROTATED Busta PRC n. 9 ruotata, da 324 a 229 millimetri
DMPAPER_PENV_10 Busta PRC 10, 324- by 458 millimetri
DMPAPER_PENV_10_ROTATED Busta PRC n. 10 ruotata, da 458 a 324 millimetri
DMPAPER_QUARTO Quarto, carta da 215 millimetri a 275 millimetri
DMPAPER_STATEMENT Istruzione, 5 1/2- per 8 1/2 pollici
DMPAPER_TABLOID Tabloid, da 11 a 17 pollici
DMPAPER_TABLOID_EXTRA Tabloid, 11,69 x 18 pollici

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperLength

Solo per i dispositivi della stampante, esegue l'override della lunghezza del foglio specificato dal membro dmPaperSize , sia per i formati di carta personalizzati che per i dispositivi quali stampanti a matrice di punti che possono stampare su una pagina di lunghezza arbitraria. Questi valori, insieme a tutti gli altri valori in questa struttura che specificano una lunghezza fisica, sono in decimi di millimetri.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPaperWidth

Solo per i dispositivi della stampante, esegue l'override della larghezza del foglio specificato dal membro dmPaperSize .

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmScale

Specifica il fattore in base al quale deve essere ridimensionato l'output stampato. Le dimensioni apparenti della pagina vengono ridimensionate rispetto alle dimensioni fisiche della pagina in base a un fattore dmScale /100. Ad esempio, una pagina di dimensioni lettera con un valore dmScale pari a 50 conterrà la quantità di dati pari a 17-by-22 pollici, perché il testo di output e la grafica sarebbero la metà dell'altezza e della larghezza originali.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmCopies

Seleziona il numero di copie stampate se il dispositivo supporta copie a più pagine.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmDefaultSource

Specifica l'origine della carta. Per recuperare un elenco delle fonti di carta disponibili per una stampante, utilizzare la funzione DeviceCapabilities con il flag DC_BINS.

Questo membro può essere uno dei valori seguenti oppure può essere un valore specifico del dispositivo maggiore o uguale a DMBIN_USER.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.dmPrintQuality

Specifica la risoluzione della stampante. Esistono quattro valori predefiniti indipendenti dal dispositivo:

Se viene specificato un valore positivo, specifica il numero di punti per pollice (DPI) ed è quindi dipendente dal dispositivo.

DUMMYUNIONNAME.dmPosition

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmPosition

Solo per i dispositivi di visualizzazione, una struttura POINTL che indica le coordinate posizionali del dispositivo di visualizzazione in riferimento all'area desktop. Il dispositivo di visualizzazione primario si trova sempre in corrispondenza delle coordinate (0,0).

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayOrientation

Solo per i dispositivi di visualizzazione, l'orientamento in corrispondenza del quale devono essere presentate le immagini. Se DM_DISPLAYORIENTATION non è impostato, questo membro deve essere zero. Se DM_DISPLAYORIENTATION è impostato, questo membro deve essere uno dei valori seguenti

Valore Significato
DMDO_DEFAULT L'orientamento dello schermo è l'orientamento naturale del dispositivo di visualizzazione; deve essere usato come impostazione predefinita.
DMDO_90 L'orientamento dello schermo viene ruotato di 90 gradi (misurata in senso orario) da DMDO_DEFAULT.
DMDO_180 L'orientamento dello schermo viene ruotato di 180 gradi (misurata in senso orario) da DMDO_DEFAULT.
DMDO_270 L'orientamento dello schermo viene ruotato di 270 gradi (misurata in senso orario) da DMDO_DEFAULT.
 

Per determinare se l'orientamento dello schermo è verticale o orizzontale, controllare il rapporto tra dmPelsWidth e dmPelsHeight.

Windows 2000: Non supportato.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.dmDisplayFixedOutput

Solo per i dispositivi di visualizzazione a risoluzione fissa, il modo in cui lo schermo presenta una modalità a bassa risoluzione su uno schermo con risoluzione superiore. Ad esempio, se la risoluzione di un dispositivo di visualizzazione è fissa a 1024 x 768 pixel, ma la modalità è impostata su 640 x 480 pixel, il dispositivo può visualizzare un'immagine 640 x 480 in una posizione interna dello spazio dello schermo 1024 x 768 o estendere l'immagine 640 x 480 per riempire lo spazio dello schermo più grande. Se DM_DISPLAYFIXEDOUTPUT non è impostato, questo membro deve essere zero. Se DM_DISPLAYFIXEDOUTPUT è impostato, questo membro deve essere uno dei valori seguenti.

Valore Significato
DMDFO_DEFAULT Impostazione predefinita della visualizzazione.
DMDFO_CENTER L'immagine a bassa risoluzione è allineata al centro nello spazio dello schermo più grande.
DMDFO_STRETCH L'immagine a bassa risoluzione viene estesa per riempire lo spazio dello schermo più grande.
 

Windows 2000: Non supportato.

dmColor

Passa tra colore e monocromatico sulle stampanti a colori. Di seguito sono indicati i valori possibili:

  • DMCOLOR_COLOR
  • DMCOLOR_MONOCHROME

dmDuplex

Seleziona la stampa duplex o fronte retro per le stampanti in grado di stampa duplex. Di seguito sono riportati i valori possibili.

Valore Significato
DMDUP_SIMPLEX Stampa normale (non plessa).
DMDUP_HORIZONTAL Associazione a arco corto, ovvero il bordo lungo della pagina è orizzontale.
DMDUP_VERTICAL Associazione a arco lungo, ovvero il bordo lungo della pagina è verticale.

dmYResolution

Specifica la risoluzione y, espressa in punti per pollice, della stampante. Se la stampante inizializza questo membro, il membro dmPrintQuality specifica la risoluzione x, espressa in punti per pollice, della stampante.

dmTTOption

Specifica la modalità di stampa dei tipi di carattere TrueType. Questo membro può essere uno dei valori seguenti.

Valore Significato
DMTT_BITMAP Stampa i tipi di carattere TrueType come grafica. Questa è l'azione predefinita per le stampanti a matrice di punti.
DMTT_DOWNLOAD Scarica i tipi di carattere TrueType come tipi di carattere soft. Si tratta dell'azione predefinita per Hewlett-Packard stampanti che usano il linguaggio PCL (Printer Control Language).
DMTT_DOWNLOAD_OUTLINE Scarica i tipi di carattere TrueType come carattere sfumati.
DMTT_SUBDEV Sostituisce i tipi di carattere del dispositivo per i tipi di carattere TrueType. Questa è l'azione predefinita per le stampanti PostScript.

dmCollate

Specifica se le regole di confronto devono essere utilizzate durante la stampa di più copie. Questo membro viene ignorato a meno che il driver della stampante non indichi il supporto per le regole di confronto impostando il membro dmFields su DM_COLLATE. Questo membro può essere uno dei valori seguenti.

Valore Significato
DMCOLLATE_TRUE Collazione durante la stampa di più copie.
DMCOLLATE_FALSE Non confrontare quando si stampano più copie.

dmFormName[CCHFORMNAME]

Matrice di caratteri con terminazione zero che specifica il nome del modulo da usare; Ad esempio, "Lettera" o "Legale". È possibile recuperare un set completo di nomi usando la funzione EnumForms .

dmLogPixels

Numero di pixel per pollice logico. I driver della stampante non usano questo membro.

dmBitsPerPel

Specifica la risoluzione dei colori, in bit per pixel, del dispositivo di visualizzazione (ad esempio: 4 bit per 16 colori, 8 bit per 256 colori o 16 bit per 65.536 colori). I driver di visualizzazione usano questo membro, ad esempio nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.

dmPelsWidth

Specifica la larghezza, in pixel, dell'area del dispositivo visibile. I driver di visualizzazione usano questo membro, ad esempio nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.

dmPelsHeight

Specifica l'altezza, in pixel, dell'area del dispositivo visibile. I driver di visualizzazione usano questo membro, ad esempio nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.dmDisplayFlags

Specifica la modalità di visualizzazione del dispositivo. Questo membro può essere una combinazione dei valori seguenti.

Valore Significato
DM_GRAYSCALE Specifica che la visualizzazione è un dispositivo noncolore. Se questo flag non è impostato, viene assunto il colore. Questo flag non è più valido.
DM_INTERLACED Specifica che la modalità di visualizzazione è interlacciata. Se il flag non è impostato, viene assunto un valore non interlacciato.
 

I driver di visualizzazione usano questo membro, ad esempio nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.

DUMMYUNIONNAME2.dmNup

Specifica la posizione in cui viene eseguita l'NUP. Può essere uno dei seguenti.

Valore Significato
DMNUP_SYSTEM Lo spooler di stampa esegue l'NUP.
DMNUP_ONEUP L'applicazione esegue l'NUP.

dmDisplayFrequency

Specifica la frequenza, in hertz (cicli al secondo), del dispositivo di visualizzazione in una modalità specifica. Questo valore è noto anche come frequenza di aggiornamento verticale del dispositivo visualizzato. I driver di visualizzazione usano questo membro. Viene usato, ad esempio, nella funzione ChangeDisplaySettings . I driver della stampante non usano questo membro.

Quando si chiama la funzione EnumDisplaySettings , il membro dmDisplayFrequency può restituire con il valore 0 o 1. Questi valori rappresentano la frequenza di aggiornamento predefinita dell'hardware di visualizzazione. Questa frequenza predefinita è in genere impostata da commutatori su una scheda di visualizzazione o scheda madre del computer o da un programma di configurazione che non usa funzioni di visualizzazione come ChangeDisplaySettings.

dmICMMethod

Specifica il modo in cui viene gestito ICM. Per un'applicazione non ICM, questo membro determina se ICM è abilitato o disabilitato. Per le applicazioni ICM, il sistema esamina questo membro per determinare come gestire il supporto di ICM. Questo membro può essere uno dei valori predefiniti seguenti o un valore definito dal driver maggiore o uguale al valore di DMICMMETHOD_USER.

Valore Significato
DMICMMETHOD_NONE Specifica che ICM è disabilitato.
DMICMMETHOD_SYSTEM Specifica che ICM viene gestito da Windows.
DMICMMETHOD_DRIVER Specifica che ICM viene gestito dal driver di dispositivo.
DMICMMETHOD_DEVICE Specifica che ICM viene gestito dal dispositivo di destinazione.
 

Il driver della stampante deve fornire un'interfaccia utente per l'impostazione di questo membro. La maggior parte dei driver della stampante supporta solo il valore DMICMMETHOD_SYSTEM o DMICMMETHOD_NONE. I driver per le stampanti PostScript supportano tutti i valori.

dmICMIntent

Specifica il metodo di corrispondenza dei colori o la finalità da utilizzare per impostazione predefinita. Questo membro è principalmente per applicazioni non ICM. Le applicazioni ICM possono stabilire finalità usando le funzioni ICM. Questo membro può essere uno dei valori predefiniti seguenti o un valore definito dal driver maggiore o uguale al valore di DMICM_USER.

Valore Significato
DMICM_ABS_COLORIMETRIC La corrispondenza dei colori deve essere ottimizzata per corrispondere al colore esatto richiesto senza mapping a punti bianchi. Questo valore è più appropriato per l'uso con la correzione.
DMICM_COLORIMETRIC La corrispondenza dei colori deve essere ottimizzata per corrispondere al colore esatto richiesto. Questo valore è più appropriato per l'uso con logo aziendali o altre immagini quando è desiderata una corrispondenza di colore esatta.
DMICM_CONTRAST La corrispondenza dei colori deve essere ottimizzata per il contrasto dei colori. Questo valore è la scelta più appropriata per le immagini analizzate o fotografiche quando si desidera eseguire il dithering.
DMICM_SATURATE La corrispondenza dei colori deve essere ottimizzata per la saturazione dei colori. Questo valore è la scelta più appropriata per i grafici aziendali quando il dithering non è desiderato.

dmMediaType

Specifica il tipo di supporto stampato. Il membro può essere uno dei valori predefiniti seguenti o un valore definito dal driver maggiore o uguale al valore di DMMEDIA_USER.

Valore Significato
DMMEDIA_STANDARD Carta semplice.
DMMEDIA_GLOSSY Carta lucida.
DMMEDIA_TRANSPARENCY Film trasparente.
 

Per recuperare un elenco dei tipi di supporti disponibili per una stampante, usare la funzione DeviceCapabilities con il flag di DC_MEDIATYPES.

dmDitherType

Specifica come eseguire il dithering. Il membro può essere uno dei valori predefiniti seguenti o un valore definito dal driver maggiore o uguale al valore di DMDITHER_USER.

Valore Significato
DMDITHER_NONE Nessuna dithering.
DMDITHER_COARSE Dithering con un pennello grossolano.
DMDITHER_FINE Dithering con un pennello fine.
DMDITHER_LINEART Dithering della linea, un metodo speciale dithering che produce bordi ben definiti tra la scala nera, bianca e grigia. Non è adatto per immagini che includono la graduazione continua in intensità e tonalità, come le fotografie analizzate.
DMDITHER_GRAYSCALE Il dispositivo esegue il ridimensionamento in grigio.

dmReserved1

Non utilizzato; deve essere zero.

dmReserved2

Non utilizzato; deve essere zero.

dmPanningWidth

Questo membro deve essere zero.

dmPanningHeight

Questo membro deve essere zero.

Commenti

I dati privati di un driver di dispositivo seguono la parte pubblica della struttura DEVMODE . Le dimensioni dei dati pubblici possono variare per le diverse versioni della struttura. Il membro dmSize specifica il numero di byte di dati pubblici e il membro dmDriverExtra specifica il numero di byte di dati privati.

Nota

L'intestazione wingdi.h definisce DEVMODE come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione wingdi.h (include Windows.h)

Vedi anche

AdvancedDocumentProperties

ChangeDisplaySettings

CreateDC

CreateIC

DeviceCapabilities

Proprietà documento

EnumDisplaySettings

OpenPrinter

Stampare le strutture dell'API Spooler

Stampa