DrvDeriveSurface 函数 (winddi.h)

DrvDeriveSurface 函数从指定的 DirectDraw 图面派生 GDI 图面。

语法

HBITMAP DrvDeriveSurface(
  DD_DIRECTDRAW_GLOBAL *pDirectDraw,
  DD_SURFACE_LOCAL     *pSurface
);

pDirectDraw

指向描述 DirectDraw 对象的 DD_DIRECTDRAW_GLOBAL 结构的指针。

pSurface

指向 DD_SURFACE_LOCAL 结构的指针，该结构描述要环绕 GDI 图面的 DirectDraw 图面。

DrvDeriveSurface 成功后，会将句柄返回到派生的 GDI 图面。如果调用失败或驱动程序无法将 GDI 绘制加速到指定的 DirectDraw 图面，则返回 NULL 。

DrvDeriveSurface 允许驱动程序创建环绕 DirectDraw 视频内存或 AGP 表面对象的 GDI 图面，以便加速 GDI 绘制到图面。如果驱动程序未挂接此调用，则所有 GDI 绘制到 DirectDraw 图面都是在使用 DIB 引擎的软件中完成的。

GDI 仅使用 RGB 表面调用 DrvDeriveSurface 。

驱动程序应调用 DrvCreateDeviceBitmap 来创建大小和格式与 DirectDraw 图面相同的 GDI 图面。无需为实际像素分配空间，因为它已存在。

要求	值
目标平台	桌面
标头	winddi.h (包括 Winddi.h)