D2D1_BITMAP_OPTIONS-Enumeration (d2d1_1.h)

Artikel
08/22/2023

Gibt an, wie eine Bitmap verwendet werden kann.

Syntax

typedef enum D2D1_BITMAP_OPTIONS {
  D2D1_BITMAP_OPTIONS_NONE = 0x00000000,
  D2D1_BITMAP_OPTIONS_TARGET = 0x00000001,
  D2D1_BITMAP_OPTIONS_CANNOT_DRAW = 0x00000002,
  D2D1_BITMAP_OPTIONS_CPU_READ = 0x00000004,
  D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE = 0x00000008,
  D2D1_BITMAP_OPTIONS_FORCE_DWORD = 0xffffffff
} ;

Konstanten


`D2D1_BITMAP_OPTIONS_NONE` Wert: 0x00000000 Die Bitmap wird mit Standardeigenschaften erstellt.
`D2D1_BITMAP_OPTIONS_TARGET` Wert: 0x00000001 Die Bitmap kann als Gerätekontextziel verwendet werden.
`D2D1_BITMAP_OPTIONS_CANNOT_DRAW` Wert: 0x00000002 Die Bitmap kann nicht als Eingabe verwendet werden.
`D2D1_BITMAP_OPTIONS_CPU_READ` Wert: 0x00000004 Die Bitmap kann von der CPU gelesen werden.
`D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE` Wert: 0x00000008 Die Bitmap funktioniert mit ID2D1GdiInteropRenderTarget::GetDC. Hinweis Dieses Flag ist in Windows Store-Apps nicht verfügbar.
`D2D1_BITMAP_OPTIONS_FORCE_DWORD` Wert: 0xffffffff

Hinweise

D2D1_BITMAP_OPTIONS_NONE impliziert, dass keines der Flags festgelegt ist. Dies bedeutet, dass die Bitmap zum Zeichnen von verwendet werden kann, nicht als Ziel festgelegt und von der CPU nicht gelesen werden kann.

D2D1_BITMAP_OPTIONS_TARGET bedeutet, dass die Bitmap als Ziel in ID2D1DeviceContext::SetTarget angegeben werden kann. Wenn Sie auch das D2D1_BITMAP_OPTIONS_CANNOT_DRAW Flag angeben, von dem die Bitmap als Ziel verwendet werden kann, aber nicht von diesem gezeichnet werden kann. Der Versuch, mit einer Bitmap zu zeichnen, für die beide Flags festgelegt sind, führt dazu, dass der Gerätekontext mit D2DERR_BITMAP_CANNOT_DRAW in einen Fehlerzustand versetzt wird.

D2D1_BITMAP_OPTIONS_CPU_READ bedeutet, dass die Bitmap mithilfe von ID2D1Bitmap1::Map zugeordnet werden kann. Dieses Flag erfordert D2D1_BITMAP_OPTIONS_CANNOT_DRAW und kann nicht mit anderen Flags kombiniert werden. Die Bitmap muss mit den Methoden CopyFromBitmap oder CopyFromRenderTarget aktualisiert werden.

Hinweis Sie sollten nur D2D1_BITMAP_OPTIONS_CANNOT_DRAW verwenden, wenn der Zweck der Bitmap nur ein Ziel ist oder wenn die Bitmap zugeordnet wird.

D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE bedeutet, dass es möglich ist, einen DC abzurufen, der dieser Bitmap zugeordnet ist. Dies muss in Verbindung mit D2D1_BITMAP_OPTIONS_TARGET verwendet werden. Die DXGI_FORMAT muss entweder DXGI_FORMAT_B8G8R8A8_UNORM oder DXGI_FORMAT_B8G8R8A8_UNORM_SRGB sein.

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]
Kopfzeile	d2d1_1.h

Weitere Informationen

ID2D1DeviceContext::CreateBitmap

Freigeben über