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 in die 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, ref]      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, ref] 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 Aufruf 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

   
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