D2D1_BITMAP_OPTIONS-Enumeration (d2d1_1.h)

  • Artikel

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