NtGdiDdUnattachSurface 函数
[此函数可能会随每个操作系统修订而更改。 请改用 Microsoft DirectDraw 和 Microsoft Direct3DAPIs;这些 API 使应用程序不受此类操作系统更改影响，并隐藏了与显示驱动程序直接交互所涉及的许多其他困难。]
删除使用 NtGdiDdAttachSurface 在两个内核模式 Surface 对象之间创建的附件。
语法
VOID APIENTRY NtGdiDdUnattachSurface(
_In_ HANDLE hSurface,
_In_ HANDLE hSurfaceAttached
);
参数
-
hSurface [in]
-
作为 hSurfaceFrom 参数传递到 NtGdiDdAttachSurface 的内核模式 Surface 对象。
-
hSurfaceAttached [in]
-
作为 hSurfaceTo 参数传递给 NtGdiDdAttachSurface 的内核模式 Surface 对象
返回值
NtGdiDdUnattachSurface 返回以下回调代码之一。
| 返回代码 | 说明 |
|---|---|
|
驱动程序已执行该操作并返回该操作的有效返回代码。 如果此代码DD_OK，则 DirectDraw 或 Direct3D 将继续执行 函数。 否则，DirectDraw 或 Direct3D 将返回驱动程序提供的错误代码并中止函数。 |
|
驱动程序对请求的操作没有注释。 如果需要驱动程序实现特定的回调，DirectDraw 或 Direct3D 会报告错误条件。 否则，DirectDraw 或 Direct3D 处理操作，就像未通过执行 DirectDraw 或 Direct3D 设备无关实现来定义驱动程序回调一样。 |
备注
建议应用程序使用 DirectDraw API，该 API 以更高级别的方式处理图面附件。
无需调用此函数，因为当调用 NtGdiDdDestroySurface 时，内核将自动销毁所有附件。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
另请参阅