Partager via


CDC::CreateDC

Crée un contexte de périphérique à l'appareil spécifié.

BOOL CreateDC(
   LPCTSTR lpszDriverName,
   LPCTSTR lpszDeviceName,
   LPCTSTR lpszOutput,
   const void* lpInitData 
);

Paramètres

  • lpszDriverName
    Pointe vers une chaîne terminée par le caractère NULL qui spécifie le nom du fichier (sans l'extension) du pilote de périphérique (par exemple, « EPSON »).Vous pouvez également passer un objet d' CString pour ce paramètre.

  • lpszDeviceName
    Pointe vers une chaîne terminée par le caractère NULL qui spécifie le nom de l'appareil spécifique à prendre en charge (par exemple, « EPSON FX-80 »).Le paramètre d' lpszDeviceName est utilisé si le module prend en charge plusieurs appareils.Vous pouvez également passer un objet d' CString pour ce paramètre.

  • lpszOutput
    Pointe vers une chaîne terminée par le caractère NULL qui spécifie le fichier ou le nom du périphérique pour la prise en charge de sortie physique (port de fichier ou de sortie).Vous pouvez également passer un objet d' CString pour ce paramètre.

  • lpInitData
    Les points à structure DEVMODE contenir des données spécifiques à l'appareil d'initialisation du pilote de périphérique.La fonction de DocumentProperties windows extrait cette structure remplie pour un appareil donné.Le paramètre d' lpInitData doit être NULL si le pilote de périphérique est d'utiliser l'initialisation par défaut (le cas échéant) spécifiée par l'utilisateur via le panneau de configuration.

Valeur de retour

Une valeur différente de zéro si la fonction est réussie ; sinon 0.

Notes

Le fichier d'en-tête de PRINT.H est obligatoire si la structure de DEVMODE est utilisée.

Les noms de périphériques suivent ces conventions : un signe deux points de terminaison (:) est recommandée, mais facultative.Les fenêtres élimine les deux-points effectuant afin qu'une fin de nom de périphérique deux-points soit mappée au même port que le même nom sans deux-points.Les noms de gestionnaire et de port ne doivent pas contenir d'espaces à gauche ou à droite.Les fonctions de sortie à GDI ne peuvent pas être utilisées avec des contextes d'informations.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CDC, classe

Graphique de la hiérarchie

DocumentProperties

CreateDC

CDC::DeleteDC

CDC::CreateIC