NtGdiDdCreateSurfaceEx 函数

[此函数可能会随每个操作系统修订而更改。请改用 DirectDraw 和 Direct3DAPIs;这些 API 使应用程序不受此类操作系统更改影响，并隐藏了与显示驱动程序直接交互所涉及的许多其他困难。]

从 Microsoft DirectDraw 图面创建 Microsoft Direct3D 图面，并将请求的句柄值关联到该图柄。

语法

DWORD APIENTRY NtGdiDdCreateSurfaceEx(
  _In_ HANDLE hDirectDraw,
  _In_ HANDLE hSurface,
  _In_ DWORD  dwSurfaceHandle
);

hDirectDraw [in]: 应用程序创建的 DirectDraw 对象的句柄。
hSurface [in]: 要为 Direct3D 创建的 DirectDraw 图面的句柄。这些句柄在每个不同的DD_DIRECTDRAW_LOCAL结构中都是唯一的。
dwSurfaceHandle [in]: 包含驱动程序创建图面所需的信息的 DD_CREATESURFACEEXDATA 结构的句柄。

NtGdiDdCreateSurfaceEx 返回以下回调代码之一。

返回代码	说明
DDHAL_DRIVER_HANDLED	驱动程序已执行该操作并返回该操作的有效返回代码。如果此代码DD_OK，则 DirectDraw 或 Direct3D 将继续执行函数。否则，DirectDraw 或 Direct3D 将返回驱动程序提供的错误代码并中止函数。
DDHAL_DRIVER_NOTHANDLED	驱动程序对请求的操作没有注释。如果需要驱动程序实现特定的回调，DirectDraw 或 Direct3D 会报告错误条件。否则，DirectDraw 或 Direct3D 处理操作，就像未通过执行 DirectDraw 或 Direct3D 设备无关实现来定义驱动程序回调一样。

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