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 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 nouvel ID2D1Factory1 qui peut être récupéré via ID2D1Resource::GetFactory.
Cette fonction crée également un nouvel 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é.
Configuration requise
| 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 |