CreateDCA-Funktion (wingdi.h)

Artikel
03/09/2024

Die CreateDC-Funktion erstellt unter Verwendung des angegebenen Namens einen Gerätekontext (Device Context, DC) für ein Gerät.

Syntax

HDC CreateDCA(
       LPCSTR         pwszDriver,
  [in] LPCSTR         pwszDevice,
       LPCSTR         pszPort,
  [in] const DEVMODEA *pdm
);

Parameter

pwszDriver

Ein Zeiger auf eine NULL-Zeichenfolge, die entweder DISPLAY oder den Namen eines bestimmten Anzeigegeräts angibt. Zum Drucken wird empfohlen, NULL an lpszDriver zu übergeben, da GDI lpszDriver für Druckergeräte ignoriert.

[in] pwszDevice

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des verwendeten Ausgabegeräts angibt, wie im Druck-Manager (z. B. Epson FX-80). Dies ist nicht der Name des Druckermodells. Der parameter lpszDevice muss verwendet werden.

Um gültige Namen für Displays zu erhalten, rufen Sie EnumDisplayDevices auf.

Wenn lpszDriver DISPLAY oder der Gerätename eines bestimmten Anzeigegeräts ist, muss lpszDeviceNULL oder denselben Gerätenamen aufweisen. Wenn lpszDeviceNULL ist, wird ein DC für das primäre Anzeigegerät erstellt.

Wenn mehrere Monitore auf dem System vorhanden sind, wird beim Aufrufen CreateDC(TEXT("DISPLAY"),NULL,NULL,NULL) ein DC erstellt, der alle Monitore abdeckt.

pszPort

Dieser Parameter wird ignoriert und sollte auf NULL festgelegt werden. Es wird nur zur Kompatibilität mit 16-Bit-Windows bereitgestellt.

[in] pdm

Ein Zeiger auf eine DEVMODE-Struktur , die gerätespezifische Initialisierungsdaten für den Gerätetreiber enthält. Die DocumentProperties-Funktion ruft diese Struktur ab, die für ein angegebenes Gerät ausgefüllt ist. Der pdm-Parameter muss NULL sein, wenn der Gerätetreiber die vom Benutzer angegebene Standardinitialisierung (falls vorhanden) verwenden soll.

Wenn lpszDriver DISPLAY ist, muss pdmNULL sein. GDI verwendet dann den aktuellen DEVMODE des Anzeigegeräts.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für einen DC für das angegebene Gerät.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Beachten Sie, dass das Handle zum DC nur von einem einzelnen Thread gleichzeitig verwendet werden kann.

Rufen Sie für die Parameter lpszDriver und lpszDeviceEnumDisplayDevices auf , um gültige Namen für Anzeigen zu erhalten.

Wenn Sie den DC nicht mehr benötigen, rufen Sie die DeleteDC-Funktion auf.

Wenn lpszDriver oder lpszDevice DISPLAY ist, besitzt der Thread, der CreateDC aufruft, den ERSTELLTEN HDC . Wenn dieser Thread zerstört wird, ist der HDC nicht mehr gültig. Wenn Sie also den HDC erstellen und an einen anderen Thread übergeben, beenden Sie den ersten Thread, kann der zweite Thread den HDC nicht verwenden.

Wenn Sie CreateDC aufrufen, um den HDC für ein Anzeigegerät zu erstellen, müssen Sie entweder NULL oder einen Zeiger auf DEVMODE an pdm übergeben, der mit dem aktuellen DEVMODE des Anzeigegeräts übereinstimmt, das lpszDevice angibt. Es wird empfohlen, NULL zu übergeben und nicht zu versuchen, genau mit dem DEVMODE für das aktuelle Anzeigegerät übereinzupassen.

Wenn Sie CreateDC aufrufen, um den HDC für ein Druckergerät zu erstellen, überprüft der Druckertreiber den DEVMODE. Wenn der Druckertreiber feststellt, dass der DEVMODE ungültig ist (d. h. der Druckertreiber kann den DEVMODE nicht konvertieren oder nutzen), stellt der Druckertreiber eine DEVMODE-Standardeinstellung bereit, um den HDC für das Druckergerät zu erstellen.

ICM: Um ICM zu aktivieren, legen Sie das dmICMMethod-Member der DEVMODE-Struktur (auf das der pInitData-Parameter verweist) auf den entsprechenden Wert fest.

Beispiele

Ein Beispiel finden Sie unter Erfassen eines Bilds.

Hinweis

Der wingdi.h-Header definiert CreateDC als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll