IDXGISurface1 ::ReleaseDC, méthode (dxgi.h)

Libère le contexte d’appareil GDI (DC) associé à la surface actuelle et vous permet d’utiliser Direct3D pour le rendu.

Syntaxe

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

Paramètres

[in, optional] pDirtyRect

Type : RECT*

Pointeur vers une structure RECT qui identifie la région sale de la surface.
Une région sale est une partie de la surface que vous avez utilisée pour le rendu GDI et que vous souhaitez conserver. Cette zone est utilisée comme indicateur de performances pour le sous-système graphique dans certains scénarios. N’utilisez pas ce paramètre pour restreindre le rendu à la région rectangulaire spécifiée. Si vous transmettez null, ReleaseDC considère la surface entière comme sale. Sinon, ReleaseDC utilise la zone spécifiée par le RECT comme indicateur de performances pour indiquer les zones qui ont été manipulées par le rendu GDI.

Vous pouvez passer un pointeur vers une structure RECT vide (un rectangle sans position ni zone) si vous n’avez modifié aucun contenu.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode n’est pas prise en charge par DXGI 1.0, fourni dans Windows Vista et Windows Server 2008. La prise en charge de DXGI 1.1 est requise, disponible sur Windows 7, Windows Server 2008 R2 et en tant que mise à jour de Windows Vista avec Service Pack 2 (SP2) (KB 971644) et Windows Server 2008 (KB 971512).

Utilisez la méthode ReleaseDC pour libérer le contrôleur de domaine et indiquer que votre application a terminé tout le rendu GDI sur cette surface.
Vous devez appeler la méthode ReleaseDC avant de pouvoir utiliser Direct3D pour effectuer un rendu supplémentaire.

Avant de redimensionner les mémoires tampons, vous devez libérer tous les contrôleurs de domaine en suspens.

Configuration requise

Voir aussi

DXGI Interfaces

IDXGISurface1