PDD_FREEDRIVERMEMORY回调函数 (ddrawint.h)

项目
03/05/2024

DdFreeDriverMemory 回调函数释放屏幕外或非本地显示内存，以满足新的分配请求。

语法

PDD_FREEDRIVERMEMORY PddFreedrivermemory;

DWORD PddFreedrivermemory(
  PDD_FREEDRIVERMEMORYDATA unnamedParam1
)
{...}

参数

unnamedParam1

指向包含免费请求详细信息的 DD_FREEDRIVERMEMORYDATA 结构。

返回值

DdFreeDriverMemory 返回以下回调代码之一：

注解

如果驱动程序具有 DirectDraw 管理所有屏幕外显示内存管理（包括 DrvCreateDeviceBitmap 的分配），则驱动程序应实现 DdFreeDriverMemory。屏幕外内存中分配的 DirectDraw 请求应始终优先于 GDI 设备位图分配。

当 DirectDraw 没有足够的屏幕外或非本地显示内存来分配应用程序请求的图面时，DirectDraw 调用 DdFreeDriverMemory 。驱动程序应将 GDI 设备位图从屏幕外内存移动到系统内存中，然后立即返回。位图移动可以通过调用 EngModifySurface 来实现。

DirectDraw 将持续调用 DdFreeDriverMemory ，直到有足够的屏幕外内存来分配请求的图面，或者直到驱动程序返回DDERR_OUTOFMEMORY。