Funzione ResetDCA (wingdi.h)

  • Articolo

La funzione ResetDC aggiorna il contesto del dispositivo della stampante o del plotter specificato usando le informazioni specificate.

Sintassi

HDC ResetDCA(
  [in] HDC            hdc,
  [in] const DEVMODEA *lpdm
);

Parametri

[in] hdc

Handle per l'aggiornamento del controller di dominio.

[in] lpdm

Puntatore a una struttura DEVMODE contenente informazioni sul nuovo controller di dominio.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il controller di dominio originale.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Un'applicazione userà in genere la funzione ResetDC quando una finestra riceve un messaggio di WM_DEVMODECHANGE . ResetDC può essere usato anche per modificare l'orientamento della carta o i contenitori di carta durante la stampa di un documento.

Impossibile usare la funzione ResetDC per modificare il nome del driver, il nome del dispositivo o la porta di output. Quando l'utente modifica la connessione alla porta o il nome del dispositivo, l'applicazione deve eliminare il controller di dominio originale e creare un nuovo controller di dominio con le nuove informazioni.

Un'applicazione può passare un controller di dominio informazioni alla funzione ResetDC . In tale situazione , ResetDC restituirà sempre un controller di dominio della stampante.

ICM: Il profilo di colore del controller di dominio specificato dal parametro hdc verrà reimpostato in base alle informazioni contenute nel membro lpInitData della struttura DEVMODE .

Nota

L'intestazione wingdi.h definisce ResetDC 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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h (include Windows.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

DEVMODE

Funzioni del contesto del dispositivo

Panoramica dei contesti del dispositivo

DeviceCapabilities

Carattere speciale di escape