通过

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

另请参阅

图形低级别客户端支持