NtGdiDdDestroySurface 函数
[此函数可能会随每个操作系统修订而更改。 请改用 DirectDraw 和 Microsoft Direct3DAPI;这些 API 使应用程序不受此类操作系统更改影响，并隐藏了与显示驱动程序直接交互所涉及的许多其他困难。]
销毁以前分配的内核模式 Microsoft DirectDraw surface 对象。
语法
DWORD APIENTRY NtGdiDdDestroySurface(
_In_ HANDLE hSurface,
_In_ BOOL bRealDestroy
);
参数
-
hSurface [in]
-
以前分配的内核模式图面对象的句柄。
-
bRealDestroy [in]
-
指定如何销毁图面。 可以是以下值之一。
-
(TRUE)
-
销毁表面并释放视频内存。
-
(FALSE)
-
释放视频内存，但使图面保持未初始化状态。
返回值
NtGdiDdDestroySurface 返回以下回调代码之一。
| 返回代码 | 说明 |
|---|---|
|
驱动程序已执行该操作并返回该操作的有效返回代码。 如果此代码DD_OK，则 DirectDraw 或 Direct3D 将继续执行 函数。 否则，DirectDraw 或 Direct3D 将返回驱动程序提供的错误代码并中止函数。 |
|
驱动程序对请求的操作没有注释。 如果需要驱动程序实现特定的回调，DirectDraw 或 Direct3D 会报告错误条件。 否则，DirectDraw 或 Direct3D 处理操作，就像未通过执行 DirectDraw 或 Direct3D 设备无关实现来定义驱动程序回调一样。 |
备注
建议应用程序使用 DirectDraw 和 Direct3D API 来创建和销毁图面，而不是此函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
另请参阅