ReleaseDC-Funktion (winuser.h)

Artikel
03/04/2024

Die ReleaseDC-Funktion gibt einen Gerätekontext (Device Context, DC) frei und gibt ihn für die Verwendung durch andere Anwendungen frei. Die Auswirkung der ReleaseDC-Funktion hängt vom Typ des DC ab. Es werden nur allgemeine DCs und Fenster-DCs freigegeben. Es hat keine Auswirkungen auf Klasse oder private DCs.

Syntax

int ReleaseDC(
  [in] HWND hWnd,
  [in] HDC  hDC
);

Parameter

[in] hWnd

Ein Handle für das Fenster, dessen DC freigegeben werden soll.

[in] hDC

Ein Handle für den DC, der freigegeben werden soll.

Rückgabewert

Der Rückgabewert gibt an, ob der DC freigegeben wurde. Wenn der DC freigegeben wurde, ist der Rückgabewert 1.

Wenn der DC nicht freigegeben wurde, ist der Rückgabewert 0.

Hinweise

Die Anwendung muss die ReleaseDC-Funktion für jeden Aufruf der GetWindowDC-Funktion und für jeden Aufruf der GetDC-Funktion aufrufen, die einen gemeinsamen DC abruft.

Eine Anwendung kann die ReleaseDC-Funktion nicht verwenden, um einen DC freizugeben, der durch Aufrufen der CreateDC-Funktion erstellt wurde. stattdessen muss die DeleteDC-Funktion verwendet werden. ReleaseDC muss aus demselben Thread aufgerufen werden, der GetDC genannt hat.

Beispiele

Ein Beispiel finden Sie unter Skalieren eines Images.

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	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll