drvCreateDeviceBitmap 函式 (winddi.h)

DrvCreateDeviceBitmap函式會建立和管理點陣圖。

語法

HBITMAP DrvCreateDeviceBitmap(
  DHPDEV dhpdev,
  SIZEL  sizl,
  ULONG  iFormat
);

dhpdev

PDEV 的控制碼，描述應用程式指定為點陣圖主要目標的實體裝置。點陣圖的格式必須與這個實體裝置相容。

sizl

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

iFormat

指定點陣圖格式，指出每個圖元所需的色彩資訊位數，且一律符合主要格式。這個值可以是下列其中一個值：

如果函式成功，傳回值是識別所建立點陣圖的控制碼。如果驅動程式選擇讓 GDI 建立和管理點陣圖，則傳回值為零。如果發生錯誤，傳回值會0xFFFFFFFF，而 GDI 會記錄錯誤碼。

如果驅動程式建立點陣圖，它可以將它儲存在任何地方，並以任何格式儲存。假設驅動程式會考慮參數的規格，並提供至少每個圖元的位數位的點陣圖。

所建立點陣圖的內容是未定義的。

此函式是選擇性的。不過，如果實作此函式，也必須實作 DrvDeleteDeviceBitmap 。


目標平台	桌上型
標頭	winddi.h (包含 Winddi.h)