drvCreateDeviceBitmap 函式 (winddi.h)
DrvCreateDeviceBitmap函式會建立和管理點陣圖。
語法
HBITMAP DrvCreateDeviceBitmap(
DHPDEV dhpdev,
SIZEL sizl,
ULONG iFormat
);
參數
dhpdev
PDEV 的控制碼，描述應用程式指定為點陣圖主要目標的實體裝置。 點陣圖的格式必須與這個實體裝置相容。
sizl
指定要建立之點陣圖的寬度和高度的 SIZEL 結構。 這個 結構的 cx 和 cy 成員分別包含點陣圖的寬度和高度，以圖元為單位。 SIZEL 結構與 SIZE 結構相同。
iFormat
指定點陣圖格式，指出每個圖元所需的色彩資訊位數，且一律符合主要格式。 這個值可以是下列其中一個值：
| 值 | 意義 |
|---|---|
| BMF_8BPP | 每個圖元 8 位。 |
| BMF_16BPP | 每個圖元 16 位。 |
| BMF_24BPP | 每個圖元 24 位。 |
| BMF_32BPP | 每個圖元 32 位。 |
傳回值
如果函式成功，傳回值是識別所建立點陣圖的控制碼。 如果驅動程式選擇讓 GDI 建立和管理點陣圖，則傳回值為零。 如果發生錯誤，傳回值會0xFFFFFFFF，而 GDI 會記錄錯誤碼。
備註
如果驅動程式建立點陣圖，它可以將它儲存在任何地方，並以任何格式儲存。 假設驅動程式會考慮參數的規格，並提供至少每個圖元的位數位的點陣圖。
所建立點陣圖的內容是未定義的。
此函式是選擇性的。 不過，如果實作此函式，也必須實作 DrvDeleteDeviceBitmap 。
規格需求
| 目標平台 | 桌上型 |
| 標頭 | winddi.h (包含 Winddi.h) |