IDXGISurface1::ReleaseDC-Methode (dxgi.h)

Gibt den GDI-Gerätekontext (DC) frei, der der aktuellen Oberfläche zugeordnet ist, und ermöglicht es Ihnen, Direct3D zum Rendern zu verwenden.

Syntax

HRESULT ReleaseDC(
  [in, optional] RECT *pDirtyRect
);

Parameter

[in, optional] pDirtyRect

Typ: RECT*

Ein Zeiger auf eine RECT-Struktur, die den modifiziert Bereich der Oberfläche identifiziert.
Eine modifiziert Region ist ein beliebiger Teil der Oberfläche, die Sie für das GDI-Rendering verwendet haben und den Sie beibehalten möchten. Dieser Bereich wird in bestimmten Szenarien als Leistungshinweis für das Grafiksubsystem verwendet. Verwenden Sie diesen Parameter nicht, um das Rendern auf den angegebenen rechteckigen Bereich einzuschränken. Wenn Sie NULL übergeben, betrachtet ReleaseDC die gesamte Oberfläche als modifiziert. Andernfalls verwendet ReleaseDC den vom RECT angegebenen Bereich als Leistungshinweis, um anzugeben, welche Bereiche vom GDI-Rendering bearbeitet wurden.

Sie können einen Zeiger auf eine leere RECT-Struktur (ein Rechteck ohne Position oder Bereich) übergeben, wenn Sie keinen Inhalt geändert haben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode wird von DXGI 1.0, das in Windows Vista und Windows Server 2008 ausgeliefert wurde, nicht unterstützt. DxGI 1.1-Unterstützung ist erforderlich, die unter Windows 7, Windows Server 2008 R2 und als Update auf Windows Vista mit Service Pack 2 (SP2) (KB 971644) und Windows Server 2008 (KB 971512) verfügbar ist.

Verwenden Sie die ReleaseDC-Methode , um den DC freizugeben, und geben Sie an, dass Ihre Anwendung das gesamte GDI-Rendering auf dieser Oberfläche abgeschlossen hat.
Sie müssen die ReleaseDC-Methode aufrufen, bevor Sie Direct3D verwenden können, um zusätzliches Rendering auszuführen.

Vor dem Ändern der Größe von Puffern müssen Sie alle ausstehenden DCs freigeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGISurface1