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) |