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

另請參閱

圖形低階客戶端支援