D2D1CreateDeviceContext, fonction (d2d1_1.h)

Article
03/04/2024

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

Surface DXGI à laquelle le contexte d’appareil Direct2D est associé.

[in, optional] creationProperties

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

[out] d2dDeviceContext

Lorsque cette fonction retourne, contient l’adresse d’un pointeur vers un contexte d’appareil Direct2D.

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

HRESULT	Description
S_OK	Aucune erreur ne s'est produite.
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 sera 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 impliqué par dxgiSurface et le suivi de débogage ne sera pas activé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	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	Windows
En-tête	d2d1_1.h
DLL	D2d1.dll