ResetDCA, fonction (wingdi.h)

  • Article

La fonction ResetDC met à jour le contexte de périphérique d’imprimante ou de traceur spécifié à l’aide des informations spécifiées.

Syntaxe

HDC ResetDCA(
  [in] HDC            hdc,
  [in] const DEVMODEA *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 pour le 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 du périphérique 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 de l’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. La combinaison 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

DEVMODE

Fonctions de contexte de l’appareil

Vue d’ensemble des contextes d’appareil

DeviceCapabilities

Caractère d'échappement