MÉTHODE ID2D1RenderTarget ::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES&,ID2D1Bitmap**) (d2d1.h)

Article
01/10/2024

Crée un ID2D1Bitmap en copiant la bitmap WIC (Microsoft Windows Imaging Component) spécifiée.

Syntaxe

HRESULT CreateBitmapFromWicBitmap(
  IWICBitmapSource               *wicBitmapSource,
  const D2D1_BITMAP_PROPERTIES & bitmapProperties,
  ID2D1Bitmap                    **bitmap
);

Paramètres

wicBitmapSource

Type : [in] IWICBitmapSource*

Bitmap WIC à copier.

bitmapProperties

Type : [in] const D2D1_BITMAP_PROPERTIES &

Format de pixel et PPP de l’image bitmap à créer. Le format de pixel doit correspondre au format de pixel de wicBitmapSource, sinon la méthode échoue. Pour éviter une incompatibilité, vous pouvez passer la valeur NULL ou transmettre la valeur obtenue lors de l’appel de la fonction d’assistance D2D1 ::P ixelFormat sans spécifier de valeurs de paramètre. Si dpiX et dpiY sont tous deux 0,0f, le DPI par défaut, 96, est utilisé. Les informations DPI incorporées dans wicBitmapSource sont ignorées.

bitmap

Type : [out] ID2D1Bitmap**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers la nouvelle bitmap. Ce paramètre est passé sans être initialisé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Remarques

Avant que Direct2D puisse charger une image bitmap WIC, cette bitmap doit être convertie au format de pixels pris en charge et en mode alpha. Pour obtenir la liste des formats de pixels et des modes alpha pris en charge, consultez Formats de pixels pris en charge et Modes alpha.

Exemples

Pour obtenir des exemples, consultez Comment charger une bitmap à partir d’un fichier et Comment charger une bitmap à partir d’une ressource.

Configuration requise


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	d2d1.h
Bibliothèque	D2d1.lib
DLL	D2d1.dll