Fonction ResetDCW (wingdi.h)
La fonction ResetDC met à jour le contexte d’imprimante ou de périphérique de traçage spécifié à l’aide des informations spécifiées.
Syntaxe
HDC ResetDCW(
[in] HDC hdc,
[in] const DEVMODEW *lpdm
);
Paramètres
[in] hdc
Handle du contrôleur de domaine à mettre à jour.
[in] lpdm
Pointeur vers une structure DEVMODE contenant des informations sur le nouveau contrôleur de domaine.
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle du contrôleur de domaine d’origine.
Si la fonction échoue, la valeur de retour est NULL.
Remarques
Une application utilise généralement la fonction ResetDC lorsqu’une fenêtre reçoit un message WM_DEVMODECHANGE . ResetDC peut également être utilisé pour modifier l’orientation du papier ou les bacs à papier lors de l’impression d’un document.
La fonction ResetDC ne peut pas être utilisée pour modifier le nom du pilote, le nom de l’appareil ou le port de sortie. Lorsque l’utilisateur modifie la connexion de port ou le nom de l’appareil, l’application doit supprimer le contrôleur de domaine d’origine et créer un contrôleur de domaine avec les nouvelles informations.
Une application peut passer un contrôleur de domaine d’informations à la fonction ResetDC . Dans ce cas, ResetDC retourne toujours un contrôleur de domaine d’imprimante.
ICM: Le profil de couleur du contrôleur de domaine spécifié par le paramètre hdc est réinitialisé en fonction des informations contenues dans le membre lpInitData de la structure DEVMODE .
Notes
L’en-tête wingdi.h définit ResetDC comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | wingdi.h (inclure Windows.h) |
| Bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |
Voir aussi
Fonctions de contexte d’appareil