ID2D1DeviceContext::CreateBitmapFromWicBitmapmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**)-Methode (d2d1_1.h)

Erstellt eine Direct2D-Bitmap durch Kopieren einer WIC-Bitmap.

Syntax

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

Die Parameter

[in] wicBitmapSource

Typ: IWICBitmapSource*

Die WIC-Bitmapquelle, aus der kopiert werden soll.

[in, optional] bitmapProperties

Typ: const D2D1_BITMAP_PROPERTIES1*

Eine Bitmapeigenschaftenstruktur, die Bitmaperstellungsoptionen angibt.

[out] bitmap

Typ: ID2D1Bitmap1**

Die Adresse des neu erstellten Bitmapobjekts.

Rückgabewert

Typ: HRESULT-

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Bemerkungen

Ab Windows 8.1 ist der BitmapProperties-Parameter optional. Wenn sie nicht angegeben ist, erbt die erstellte Bitmap das Pixelformat und den Alphamodus von wicBitmapSource. Eine Liste der unterstützten Pixelformate und Alphamodi finden Sie unter Unterstützte Pixelformate und Alphamodi.

Wenn der BitmapProperties-Parameter angegeben wird, muss der Wert in bitmapProperties-pixelFormat> entweder DXGI_FORMAT_UNKNOWN sein oder mit dem WIC-Pixelformat in wicBitmapSource übereinstimmen.

Wenn bitmapProperties-pixelFormat.alphaMode> auf D2D1_ALPHA_MODE_UNKNOWN festgelegt ist, erbt die neu erstellte Bitmap den Alphamodus von wicBitmapSource. Wenn bitmapProperties-pixelFormat.alphaMode> auf D2D1_ALPHA_MODE_PREMULTIPLIED, D2D1_ALPHA_MODE_STRAIGHT oder D2D1_ALPHA_MODE_IGNORE festgelegt ist, erzwingt die neu erstellte Bitmap die Verwendung des angegebenen Alphamodus.

Anforderungen

Siehe auch

ID2D1DeviceContext