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