ID2D1RenderTarget::CreateBitmapFromWicBitmapmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES*,ID2D1Bitmap**)-Methode (d2d1.h)
Erstellt eine ID2D1Bitmap durch Kopieren der angegebenen WiC-Bitmap (Microsoft Windows Imaging Component).
Syntax
HRESULT CreateBitmapFromWicBitmap(
IWICBitmapSource *wicBitmapSource,
const D2D1_BITMAP_PROPERTIES *bitmapProperties,
[out] ID2D1Bitmap **bitmap
);
Parameter
wicBitmapSource
Typ: [in] IWICBitmapSource*
Die zu kopierende WIC-Bitmap.
bitmapProperties
Typ: [in, optional] const D2D1_BITMAP_PROPERTIES*
Das Pixelformat und dpi der zu erstellenden Bitmap. Das Pixelformat muss mit dem Pixelformat von wicBitmapSource übereinstimmen, andernfalls schlägt die Methode fehl. Um einen Konflikt zu verhindern, können Sie NULL übergeben oder den Wert übergeben, der durch das Aufrufen der Hilfsfunktion D2D1::P ixelFormat abgerufen wurde, ohne Parameterwerte anzugeben. Wenn sowohl dpiX als auch dpiY 0.0f sind, wird der Standard-DPI 96 verwendet. DPI-Informationen, die in wicBitmapSource eingebettet sind, werden ignoriert.
[out] bitmap
Typ: ID2D1Bitmap**
Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf die neue Bitmap. Dieser Parameter wird nicht initialisiert übergeben.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Bevor Direct2D eine WIC-Bitmap laden kann, muss diese Bitmap in ein unterstütztes Pixelformat und den Alphamodus konvertiert werden. Eine Liste der unterstützten Pixelformate und Alphamodi finden Sie unter Unterstützte Pixelformate und Alphamodi.
Beispiele
Beispiele finden Sie unter Laden einer Bitmap aus einer Datei und Laden einer Bitmap aus einer Ressource.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1.h |
| Bibliothek | D2d1.lib |
| DLL | D2d1.dll |