D2D1_BITMAP_OPTIONS 枚举 (d2d1_1.h)

指定位图的使用方式。

语法

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
} ;

常量

 
D2D1_BITMAP_OPTIONS_NONE
值: 0x00000000
使用默认属性创建位图。
D2D1_BITMAP_OPTIONS_TARGET
值: 0x00000001
位图可用作设备上下文目标。
D2D1_BITMAP_OPTIONS_CANNOT_DRAW
值: 0x00000002
位图不能用作输入。
D2D1_BITMAP_OPTIONS_CPU_READ
值: 0x00000004
可以从 CPU 读取位图。
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE
值: 0x00000008
位图适用于 ID2D1GdiInteropRenderTarget::GetDC

注意 此标志在 Windows 应用商店应用中不可用。

 
D2D1_BITMAP_OPTIONS_FORCE_DWORD
值: 0xffffffff

注解

D2D1_BITMAP_OPTIONS_NONE 表示未设置任何标志。 这意味着位图可用于绘制,不能设置为目标,也不能由 CPU 从中读取。

D2D1_BITMAP_OPTIONS_TARGET 意味着位图可以指定为 ID2D1DeviceContext::SetTarget 中的目标。 如果还指定 了D2D1_BITMAP_OPTIONS_CANNOT_DRAW 标志可以使用位图作为目标,但不能从中绘制。 尝试使用同时设置了两个标志的位图绘制将导致设备上下文进入错误状态 ,并D2DERR_BITMAP_CANNOT_DRAW

D2D1_BITMAP_OPTIONS_CPU_READ 表示可以使用 ID2D1Bitmap1::Map 映射位图。 此标志需要 D2D1_BITMAP_OPTIONS_CANNOT_DRAW ,不能与任何其他标志组合使用。 必须使用 CopyFromBitmapCopyFromRenderTarget 方法更新位图。

注意 只应使用 D2D1_BITMAP_OPTIONS_CANNOT_DRAW 当位图的目的只是作为目标或位图将被映射时。
 
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE 意味着可以获取与此位图关联的 DC。 这必须与 D2D1_BITMAP_OPTIONS_TARGET 结合使用。 DXGI_FORMAT必须是DXGI_FORMAT_B8G8R8A8_UNORMDXGI_FORMAT_B8G8R8A8_UNORM_SRGB

要求

   
最低受支持的客户端 适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 |UWP 应用]
标头 d2d1_1.h

另请参阅

ID2D1DeviceContext::CreateBitmap