NtGdiDdGetDC 函数

[此函数可能会随每个操作系统修订版而更改。 请改用 Microsoft DirectDraw 和 Microsoft Direct3DAPI;这些 API 将应用程序与此类操作系统更改隔离开来,并隐藏与显示驱动程序直接交互时涉及的许多其他困难。]

为指定的图面创建设备上下文 (DC) 。

语法

HDC APIENTRY NtGdiDdGetDC(
  _In_ HANDLE       hSurface,
  _In_ PALETTEENTRY *puColorTable
);

参数

hSurface [in]

以前由 NtGdiDdCreateSurface 或 NtGdiDdCreateSurfaceObject 返回的内核模式 DirectDraw 图面的句柄。

puColorTable [in]

指向返回的 DC 的替代颜色表的指针。

返回值

如果成功,此函数将返回有效的 HDC;否则返回 NULL

备注

在任何给定时间,每个图面都只允许一个 DC。 对 NtGdiDdGetDC 的后续调用将失败,直到释放上一个 DC。

建议应用程序改为调用 IDirectDrawSurface7::GetDC ,后者以独立于操作系统的方式提供相同的功能。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Ntgdi.h

另请参阅

图形低级别客户端支持

DdGetDC