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

Retourne un contexte d’appareil qui vous permet d’effectuer un rendu sur une surface DXGI (Microsoft DirectX Graphics Infrastructure) à l’aide de l’interface GDI (Windows Graphics Device Interface).

Syntaxe

HRESULT GetDC(
        BOOL Discard,
  [out] HDC  *phdc
);

Paramètres

Discard

Type : BOOL

Valeur booléenne qui spécifie s’il faut conserver le contenu Direct3D dans le contrôleur de domaine GDI. TRUE indique au runtime de ne pas conserver le contenu Direct3D dans le contrôleur de domaine GDI ; autrement dit, le runtime ignore le contenu Direct3D. FALSE garantit que le contenu Direct3D est disponible dans le contrôleur de domaine GDI.

[out] phdc

Type : HDC*

Pointeur vers un handle HDC qui représente le contexte d’appareil actuel pour le rendu GDI.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ; sinon, un code d’erreur.

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 (Ko 971512).

Après avoir utilisé la méthode GetDC pour récupérer un contrôleur de domaine, vous pouvez effectuer un rendu sur la surface DXGI à l’aide de GDI.
La méthode GetDC lit la surface pour le rendu GDI et permet l’inter-opération entre les technologies DXGI et GDI.

Gardez à l’esprit les points suivants lors de l’utilisation de cette méthode :

Vous pouvez également appeler GetDC sur la mémoire tampon arrière à l’index 0 d’une chaîne d’échange en obtenant un IDXGISurface1 à partir de la chaîne d’échange. Le code suivant illustre le processus.

IDXGISwapChain* g_pSwapChain = NULL;
IDXGISurface1* g_pSurface1 = NULL;
...
//Setup the device and the swapchain
g_pSwapChain->GetBuffer(0, __uuidof(IDXGISurface1), (void**) &g_pSurface1);
g_pSurface1->GetDC( FALSE, &g_hDC );
...      
//Draw on the DC using GDI
...
//When finish drawing release the DC
g_pSurface1->ReleaseDC( NULL );
      

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête dxgi.h
Bibliothèque DXGI.lib

Voir aussi

DXGI Interfaces

IDXGISurface1