通过

NtGdiDdFlip 函数

  • 项目

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

使与目标图面和当前图面关联的表面内存交换。

语法

DWORD APIENTRY NtGdiDdFlip(
  _In_    HANDLE       hSurfaceCurrent,
  _In_    HANDLE       hSurfaceTarget,
  _In_    HANDLE       hSurfaceCurrentLeft,
  _In_    HANDLE       hSurfaceTargetLeft,
  _Inout_ PDD_FLIPDATA puFlipData
);

参数

hSurfaceCurrent [in]

描述当前图面 的DD_SURFACE_LOCAL 结构的句柄。

hSurfaceTarget [in]

描述目标表面 的DD_SURFACE_LOCAL 结构的句柄;即驱动程序应翻转到的图面。

hSurfaceCurrentLeft [in]

描述当前左图 面的DD_SURFACE_LOCAL 结构的句柄。

hSurfaceTargetLeft [in]

描述要翻转的左侧目标图面 的DD_SURFACE_LOCAL 结构的句柄。

puFlipData [in， out]

指向 DD_FLIPDATA 结构的指针，该结构包含执行翻转所需的信息。

返回值

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

返回代码 说明
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

另请参阅

图形低级别客户端支持