Share via

ID2D1DeviceContext::CreateBitmap(D2D1_SIZE_U,constvoid*,UINT32,constD2D1_BITMAP_PROPERTIES1&,ID2D1Bitmap1**)-Methode (d2d1_1.h)

  • Artikel

Erstellt eine Bitmap, die als Zieloberfläche, zum Lesen zur CPU oder als Quelle für die DrawBitmap - und ID2D1BitmapBrush-APIs verwendet werden kann. Darüber hinaus können Farbkontextinformationen an die Bitmap übergeben werden.

Syntax

HRESULT CreateBitmap(
                 D2D1_SIZE_U                     size,
  [in, optional] const void                      *sourceData,
                 UINT32                          pitch,
  [in]           const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
  [out]          ID2D1Bitmap1                    **bitmap
);

Parameter

size

Typ: D2D1_SIZE_U

Die Pixelgröße der zu erstellenden Bitmap.

[in, optional] sourceData

Typ: const void*

Die anfänglichen Daten, die in die Bitmap geladen werden.

pitch

Typ: UINT32

Die Tonhöhe der Quelldaten, sofern angegeben.

[in] bitmapProperties

Typ: const D2D1_BITMAP_PROPERTIES1*

Die Eigenschaften der zu erstellenden Bitmap.

[out] bitmap

Typ: ID2D1Bitmap1**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf ein neues Bitmapobjekt.

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 Anruf abzuschließen.
E_INVALIDARG Ein ungültiger Wert wurde an die -Methode übergeben.
D3DERR_OUTOFVIDEOMEMORY Direct3D verfügt nicht über genügend Anzeigespeicher, um den Vorgang auszuführen.

Hinweise

Die neue Bitmap kann als Ziel für SetTarget verwendet werden, wenn sie mit D2D1_BITMAP_OPTIONS_TARGET erstellt wird.

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

D2D1_BITMAP_PROPERTIES1

D2D1_SIZE_U

ID2D1Bitmap1

ID2D1DeviceContext