CreateCompatibleDC-Funktion (wingdi.h)

Artikel
08/27/2023

Die CreateCompatibleDC-Funktion erstellt einen Speichergerätekontext (DC), der mit dem angegebenen Gerät kompatibel ist.

Syntax

HDC CreateCompatibleDC(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für einen vorhandenen DC. Wenn dieses Handle NULL ist, erstellt die Funktion einen Speicher-DC, der mit dem aktuellen Bildschirm der Anwendung kompatibel ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für einen Speicher-DC.

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

Hinweise

Ein Speicher-DC ist nur im Arbeitsspeicher vorhanden. Wenn der Speicher-DC erstellt wird, ist die Anzeigeoberfläche genau ein monochromes Pixel breit und ein monochromes Pixel hoch. Bevor eine Anwendung einen Speicher-DC für Zeichnungsvorgänge verwenden kann, muss sie eine Bitmap mit der richtigen Breite und Höhe im DC auswählen. Um eine Bitmap in einen DC auszuwählen, verwenden Sie die CreateCompatibleBitmap-Funktion, und geben Sie die erforderliche Höhe, Breite und Farbe organization an.

Wenn ein Speicher-DC erstellt wird, werden alle Attribute auf normale Standardwerte festgelegt. Der Speicher-DC kann als normaler DC verwendet werden. Sie können die Attribute festlegen. die aktuellen Einstellungen seiner Attribute abrufen; und wählen Sie Stifte, Pinsel und Regionen aus.

Die CreateCompatibleDC-Funktion kann nur mit Geräten verwendet werden, die Rastervorgänge unterstützen. Eine Anwendung kann ermitteln, ob ein Gerät diese Vorgänge unterstützt, indem sie die GetDeviceCaps-Funktion aufruft .

Wenn Sie den Speicher dc nicht mehr benötigen, rufen Sie die DeleteDC-Funktion auf. Es wird empfohlen, DeleteDC aufzurufen, um den DC zu löschen. Sie können jedoch auch DeleteObject mit dem HDC aufrufen, um den DC zu löschen.

Wenn hdcNULL ist, besitzt der Thread, der CreateCompatibleDC aufruft, die erstellte HDC. Wenn dieser Thread zerstört wird, ist die HDC nicht mehr gültig. Wenn Sie also die HDC erstellen und an einen anderen Thread übergeben, beenden Sie den ersten Thread, kann der zweite Thread den HDC nicht verwenden.

ICM: Wenn der dc, der an diese Funktion übergeben wird, für die Bildfarbverwaltung (Image Color Management, ICM) aktiviert ist, ist der von der Funktion erstellte DC ICM-fähig. Die Quell- und Zielfarbräume werden im DC angegeben.

Beispiele

Ein Beispiel finden Sie unter Erfassen eines Bilds.

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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll