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] const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
[out] ID2D1Bitmap1 **bitmap
);
参数
size
类型: D2D1_SIZE_U
要创建的位图的像素大小。
[in, optional] sourceData
类型: const void*
将加载到位图中的初始数据。
pitch
类型: UINT32
源数据的间距(如果已指定)。
[in] 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 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | d2d1_1.h |
DLL | D2d1.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈