共用方式為


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 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1_1.h
Dll D2d1.dll

另請參閱

ID2D1Bitmap1

ID2D1DeviceCoNtext::CreateBitmap

ID2D1DeviceCoNtext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap