Partager via


MÉTHODE ID2D1DeviceContext ::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

Crée une bitmap à partir d’une surface DXGI qui peut être définie en tant que surface cible ou avoir des informations de contexte de couleur supplémentaires spécifiées.

Syntaxe

HRESULT CreateBitmapFromDxgiSurface(
  [in]           IDXGISurface                  *surface,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Paramètres

[in] surface

Type : IDXGISurface*

Surface DXGI à partir de laquelle la bitmap peut être créée.

Note La surface DXGI doit avoir été créée à partir du même appareil Direct3D auquel le contexte d’appareil Direct2D est associé.
 

[in, optional] bitmapProperties

Type : const D2D1_BITMAP_PROPERTIES1*

Propriétés bitmap spécifiées en plus de la surface.

[out] bitmap

Type : ID2D1Bitmap1**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers un nouvel objet 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.
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.
D3DERR_OUTOFVIDEOMEMORY Direct3D n’a pas suffisamment de mémoire d’affichage pour effectuer l’opération.

Remarques

Si les propriétés bitmap ne sont pas spécifiées, les informations suivantes sont supposées :

  • Le DPI bitmap est 96.
  • Le format de pixel correspond à celui de la surface.
  • La bitmap retournée héritera des indicateurs de liaison de la surface DXGI.
    • Toutefois, seul le sous-ensemble d’indicateurs significatifs pour Direct2D sera hérité. Par exemple, D3D10_USAGE_DYNAMIC n’est pas compatible avec les indicateurs Direct2D publics.
  • Le contexte de couleur est inconnu.
  • Le mode alpha de la bitmap est prémultiplié (cas courant) ou droit (A8).
Si les propriétés bitmap sont spécifiées, les propriétés bitmap sont utilisées comme suit :
  • Le DPI bitmap sera spécifié par les propriétés bitmap.
  • Si dpiX et dpiY sont tous deux 0, le DPI bitmap sera 96.
  • Le format de pixel doit être compatible avec l’affichage des ressources du nuanceur ou la vue cible de rendu de la surface.
  • Les options bitmap doivent être compatibles avec les indicateurs de liaison de la surface DXGI. Toutefois, il peut s’agir d’un sous-ensemble. Cela influence les vues de ressources créées par la bitmap.
  • Les informations de contexte de couleur seront utilisées à partir des propriétés bitmap, si elles sont spécifiées.

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

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext ::SetTarget