Freigeben über


CDC::CreateDC

Erstellt einen Gerätekontext für das angegebene Gerät.

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

Parameter

  • lpszDriverName
    Zeigt auf eine auf NULL endende Zeichenfolge, die den Dateinamen (ohne Dateinamenerweiterung) des Gerätetreibers angibt (beispielsweise, "EPSON").Sie können ein CString-Objekt für diesen Parameter übergeben.

  • lpszDeviceName
    Zeigt auf eine auf NULL endende Zeichenfolge, die den Namen des bestimmten angibt (beispielsweise, "EPSON FX-80" unterstützt werden Geräts,).Der lpszDeviceName-Parameter wird verwendet, wenn das Modul mehr als ein Gerät unterstützt.Sie können ein CString-Objekt für diesen Parameter übergeben.

  • lpszOutput
    Zeigt auf eine auf NULL endende Zeichenfolge, die die Datei oder den Gerätenamen für den physischen Ausgabemedium angibt (Datei oder Ausgabeanschluss).Sie können ein CString-Objekt für diesen Parameter übergeben.

  • lpInitData
    Zeigt auf eine DEVMODE-Struktur, die gerätespezifische Initialisierungsdaten für den Gerätetreiber enthält.Die Funktion Windows DocumentProperties ruft diese Struktur vertrat ein bestimmtes Gerät ab.Der lpInitData-Parameter muss NULL sein, wenn der Gerätetreiber, die Standardinitialisierung zu verwenden (falls vorhanden) angegeben vom Benutzer über die Systemsteuerung ist.

Rückgabewert

ungleich 0 (null), wenn die Funktion erfolgreich; 0 andernfalls.

Hinweise

Die PRINT.H-Headerdatei ist erforderlich, wenn die DEVMODE-Struktur verwendet wird.

Gerätenamen führen diesen Konventionen: ein Endedoppelpunkt (:) wird empfohlen, ist jedoch optional.Windows entfernt den endenden Doppelpunkt, damit ein Gerätenamenende mit einem Doppelpunkt auf demselben Port wie der gleiche Name ohne einen Doppelpunkt zugeordnet ist.Der Treiber und die Anschlussnamen dürfen führende oder nachgestellte Leerzeichen enthalten.GDI-Ausgabefunktionen können nicht mit Informationskontexten verwendet werden.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchien-Diagramm

DocumentProperties

CreateDC

CDC::DeleteDC

CDC::CreateIC