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
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 |