Funzione ResetDCA (wingdi.h)
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
Funzioni del contesto del dispositivo