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

  • Artikel

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
);

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ögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT BESCHREIBUNG
S_OK Kein Fehler ist aufgetreten.
E_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Aufruf abzuschließen.
E_INVALIDARG Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben.

Hinweise

Ab Windows 8.1 ist der BitmapProperties-Parameter optional. Wenn sie nicht angegeben wird, 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 oder dem WIC-Pixelformat> in wicBitmapSource entsprechen.

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 dies, dass die neu erstellte Bitmap den angegebenen Alphamodus verwendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1_1.h
DLL D2d1.dll

Weitere Informationen

ID2D1DeviceContext