ID2D1Bitmap1 ::GetSurface, méthode (d2d1_1.h)
Obtient soit la surface qui a été spécifiée lors de la création de la bitmap, soit la surface par défaut créée lors de la création de la bitmap.
Syntaxe
HRESULT GetSurface(
[out, optional] IDXGISurface **dxgiSurface
);
Paramètres
[out, optional] dxgiSurface
Type : IDXGISurface**
Surface DXGI sous-jacente pour la bitmap.
Valeur retournée
Type : HRESULT
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| HRESULT | Description |
|---|---|
| S_OK | Aucune erreur ne s'est produite. |
| D2DERR_BITMAP_BOUND_AS_TARGET | Impossible de dessiner avec une bitmap actuellement liée en tant que bitmap cible. |
Remarques
La bitmap utilisée doit avoir été créée à partir d’une cible de rendu de surface DXGI, d’une cible de rendu dérivée ou d’un contexte d’appareil créé à partir d’un ID2D1Device.
La surface retournée peut être utilisée avec Microsoft Direct3D ou toute autre API qui interagit avec des surfaces partagées. L’application doit s’assurer transitivement que la surface est utilisable sur l’appareil Direct3D utilisé dans ce contexte. Par exemple, si vous utilisez la surface avec Direct2D, la cible de rendu Direct2D doit avoir été créée via ID2D1Factory ::CreateDxgiSurfaceRenderTarget ou sur un contexte d’appareil créé sur le même appareil.
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 |
Voir aussi
ID2D1DeviceContext ::CreateBitmap