MÉTHODE ID2D1DeviceContext ::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

Crée une image bitmap Direct2D en copiant une image bitmap WIC.

Syntaxe

HRESULT CreateBitmapFromWicBitmap(
  [in]           IWICBitmapSource              *wicBitmapSource,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Paramètres

[in] wicBitmapSource

Type : IWICBitmapSource*

Source bitmap WIC à partir de laquelle effectuer la copie.

[in, optional] bitmapProperties

Type : const D2D1_BITMAP_PROPERTIES1*

Structure de propriétés bitmap qui spécifie les options de création de bitmap.

[out] bitmap

Type : ID2D1Bitmap1**

Adresse de l’objet bitmap nouvellement créé.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Remarques

À compter de Windows 8.1, le paramètre bitmapProperties est facultatif. Lorsqu’elle n’est pas spécifiée, l’image bitmap créée hérite du format de pixels et du mode alpha de wicBitmapSource. 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.

Lorsque le paramètre bitmapProperties est spécifié, la valeur dans bitmapProperties-pixelFormat> doit être DXGI_FORMAT_UNKNOWN ou correspondre au format de pixel WIC dans wicBitmapSource.

Lorsque bitmapProperties-pixelFormat.alphaMode> a la valeur D2D1_ALPHA_MODE_UNKNOWN, le bitmap nouvellement créé hérite du mode alpha de wicBitmapSource. Lorsque bitmapProperties-pixelFormat.alphaMode> a la valeur D2D1_ALPHA_MODE_PREMULTIPLIED, D2D1_ALPHA_MODE_STRAIGHT ou D2D1_ALPHA_MODE_IGNORE, cela force la bitmap nouvellement créée à utiliser le mode alpha spécifié.

Configuration requise

Voir aussi

ID2D1DeviceContext