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