ID2D1DeviceContext::CreateBitmap (D2D1_SIZE_U,constvoid*,UINT32,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) 方法 (d2d1_1.h)

创建一个位图,该位图可用作目标图面、用于读回 CPU,或用作 DrawBitmapID2D1BitmapBrush API 的源。 此外,颜色上下文信息可以传递给位图。

语法

HRESULT CreateBitmap(
                 D2D1_SIZE_U                   size,
  [in, optional] const void                    *sourceData,
                 UINT32                        pitch,
  [in, ref]      const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

参数

size

类型: D2D1_SIZE_U

要创建的位图的像素大小。

[in, optional] sourceData

类型: const void*

将加载到位图中的初始数据。

pitch

类型: UINT32

源数据的间距(如果指定)。

[in, ref] bitmapProperties

类型: const D2D1_BITMAP_PROPERTIES1

要创建的位图的属性。

[out] bitmap

类型: ID2D1Bitmap1**

此方法返回时,包含指向新位图对象的指针的地址。

返回值

类型: HRESULT

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

HRESULT 说明
S_OK 未发生错误。
E_OUTOFMEMORY Direct2D 无法分配足够的内存来完成调用。
E_INVALIDARG 传递给方法的值无效。
D3DERR_OUTOFVIDEOMEMORY Direct3D 没有足够的显示内存来执行该操作。

备注

如果使用 D2D1_BITMAP_OPTIONS_TARGET 创建新位图,则可以将其用作 SetTarget 的目标。

要求

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

另请参阅

D2D1_BITMAP_PROPERTIES1

D2D1_SIZE_U

ID2D1Bitmap1

ID2D1DeviceContext