ID2D1Bitmap1：：Map 方法 (d2d1_1.h)

将给定位图映射到内存中。

语法

HRESULT Map(
        D2D1_MAP_OPTIONS options,
  [out] D2D1_MAPPED_RECT *mappedRect
);

参数

options

类型： D2D1_MAP_OPTIONS

将位图映射到内存中使用的选项。

[out] mappedRect

类型： D2D1_MAPPED_RECT*

此方法返回时，包含对映射到内存中的矩形的引用。

返回值

类型： HRESULT

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

HRESULT	说明
S_OK	未发生错误。
E_INVALIDARG	一个或多个参数无效
D3DERR_DEVICELOST	设备已丢失，但此时无法重置。

备注

注意 映射时，不能将位图用于某些目的。 特别是，如果映射了源位图或目标位图， 则 ID2D1Bitmap：：CopyFromBitmap 方法不起作用。

 

必须已使用指定的 D2D1_BITMAP_OPTIONS_CPU_READ 标志创建位图。

要求

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

另请参阅

ID2D1Bitmap1

ID2D1DeviceContext：：CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget：：CreateSharedBitmap