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

另請參閱

D2D1_BITMAP_PROPERTIES1

D2D1_SIZE_U

ID2D1Bitmap1

ID2D1DeviceCoNtext