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 來刪除位圖。

規格需求

另請參閱

EngCreateBitmap