DdCreateDIBSection 函数 (ddrawgdi.h)
[此函数可能会随每个操作系统修订版而更改。 请改用 Microsoft DirectDraw 和 Microsoft Direct3DAPI;这些 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 成员是由 hdc 指定的设备上下文逻辑调色板中的 16 位索引组成的数组。
(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 |