EngCreateDeviceBitmap 函式 (winddi.h)

EngCreateDeviceBitmap 函式會要求 GDI 來建立裝置位圖的句柄。

語法

ENGAPI HBITMAP EngCreateDeviceBitmap(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

[in] dhsurf

要建立之裝置位圖的裝置句柄。

[in] sizl

指定 SIZEL 結構，其中包含要建立之位圖的寬度和高度。這個結構的 cx 和 cy 成員分別包含位圖的寬度和高度，以像素為單位。 SIZEL 結構與 SIZE 結構相同。

iFormatCompat

指定所建立之裝置介面的相容引擎格式。如果需要暫存緩衝區來模擬複雜的繪圖呼叫，則 GDI 會使用此緩衝區。 iFormatCompat 的允許值為 BMF_1BPP、BMF_4BPP、BMF_8BPP、BMF_16BPP、BMF_24BPP 和 BMF_32BPP。

如果函式成功，傳回值是識別位圖的句柄。否則，它會是零，而且會記錄錯誤碼。

介面應該使用 EngAssociateSurface 來建立關聯。當不再需要位圖時，應該呼叫 EngDeleteSurface 來刪除位圖。

需求	值
最低支援的用戶端	可在 Windows 2000 和更新版本的 Windows 作業系統中使用。
目標平台	Universal
標頭	winddi.h (包括 Winddi.h)
程式庫	Win32k.lib
Dll	Win32k.sys