ID2D1DeviceContext::CreateBitmap(D2D1_SIZE_U,constvoid*,UINT32,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**)-Methode (d2d1_1.h)
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für