Partager via


D2D1CreateDeviceContext, fonction (d2d1_1.h)

Crée un contexte d’appareil Direct2D associé à une surface DXGI.

Syntaxe

HRESULT D2D1CreateDeviceContext(
  [in]           IDXGISurface                   *dxgiSurface,
  [in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
  [out]          ID2D1DeviceContext             **d2dDeviceContext
);

Paramètres

[in] dxgiSurface

La surface DXGI du contexte d’appareil Direct2D est associée.

[in, optional] creationProperties

Propriétés à appliquer au contexte d’appareil Direct2D.

[out] d2dDeviceContext

Lorsque cette fonction est retournée, contient l’adresse d’un pointeur vers un contexte d’appareil Direct2D.

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

HRESULT Descriptif
S_OK Aucune erreur n’a eu lieu.
E_OUTOFMEMORY Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel.
E_INVALIDARG Une valeur non valide a été passée à la méthode.

Remarques

Cette fonction crée également un ID2D1Factory1 qui peut être récupéré via ID2D1Resource ::GetFactory.

Cette fonction crée également un ID2D1Device qui peut être récupéré via ID2D1DeviceContext ::GetDevice.

L’appareil DXGI est spécifié implicitement via dxgiSurface.

Si creationProperties n’est pas spécifié, l’appareil Direct2D héritera de son mode de thread de l’appareil DXGI implicite par dxgiSurface et le traçage de débogage ne sera pas activé.

Spécifications

Requirement Valeur
Client minimum requis Windows 8 et Mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et Mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header d2d1_1.h
Library d2d1.lib
DLL D2d1.dll

Voir aussi

D2D1CreateDevice

D2D1CreateDeviceContext

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource ::GetFactory