ID2D1DeviceContext::CreateBitmap (D2D1_SIZE_U,constvoid*,UINT32,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) 方法 (d2d1_1.h)
创建一个位图,该位图可用作目标图面、用于读回 CPU,或用作 DrawBitmap 和 ID2D1BitmapBrush 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 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈