DdCreateDIBSection 函式 (ddrawgdi.h)
[此函式可能會隨著每個作業系統修訂而變更。 請改用 Microsoft DirectDraw 和 Microsoft Direct3DAPIs;這些 API 會隔離應用程式與這類操作系統變更，並隱藏與顯示驅動程式直接互動所涉及的許多其他困難。
建立與裝置共用其色彩表格 的 DIBSECTION 結構。
GdiEntry9 定義為此函式的別名。
語法
HBITMAP DdCreateDIBSection(
HDC hdc,
const BITMAPINFO *pbmi,
UINT iUsage,
VOID **ppvBits,
HANDLE hSectionApp,
DWORD dwOffset
);
參數
hdc
與目前顯示裝置相容的有效 DC。
pbmi
描述所要求 DIBSECTION之 BITMAPINFO 結構的指標。
iUsage
指定 pbmi 所指向之 BITMAPINFO 結構的 bmiColors 陣列成員中所包含資料類型， (邏輯調色盤索引或常值 RGB 值) 。 定義下列值。
(DIB_PAL_COLORS)
bmiColors 成員是 16 位索引的陣列，位於 hdc 所指定裝置內容的邏輯調色盤中。
(DIB_RGB_COLORS)
BITMAPINFO 結構包含常值 RGB 值的陣列。
ppvBits
指向所建立 DIBSECTION 數據的指標。
hSectionApp
保留的。 必須是 NULL。
dwOffset
傳回值
如果成功，此函式會將句柄傳回代表 DIBSECTION 的點陣圖;否則會傳回 NULL。
備註
呼叫此函式可確保呼叫 IDirectDrawSurface7：：Blt 或 StretchBlt 時，不會進行調色盤轉換。
建議使用 IDirectDrawSurface7，此介面可以建立 8 位每像素的識別調色板表面，與操作系統無關。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | ddrawgdi.h |