PDD_FREEDRIVERMEMORY コールバック関数 (ddrawint.h)

[アーティクル]
02/26/2024

DdFreeDriverMemory コールバック関数は、新しい割り当て要求を満たすために、offscreen または非ローカル表示メモリを解放します。

構文

PDD_FREEDRIVERMEMORY PddFreedrivermemory;

DWORD PddFreedrivermemory(
  PDD_FREEDRIVERMEMORYDATA unnamedParam1
)
{...}

パラメーター

unnamedParam1

空き要求の詳細を含む DD_FREEDRIVERMEMORYDATA 構造体を指します。

戻り値

DdFreeDriverMemory は、次のいずれかのコールバックコードを返します。

注釈

ドライバーは、DirectDraw が DrvCreateDeviceBitmap の割り当てを含むすべてのオフスクリーン表示メモリ管理を管理している場合に、DdFreeDriverMemory を実装する必要があります。オフスクリーンメモリ内の割り当てに対する DirectDraw 要求は、常に GDI デバイスのビットマップ割り当てよりも優先されます。

DirectDraw は、アプリケーションによって要求されたサーフェスを割り当てるのに十分なオフスクリーンまたは非ローカル表示メモリがない場合に DdFreeDriverMemory を呼び出します。ドライバーは、オフスクリーンメモリからシステムメモリに GDI デバイスビットマップを移動し、すぐに戻る必要があります。ビットマップの移動は、 EngModifySurface を呼び出すことによって実現できます。

DirectDraw は、要求されたサーフェスを割り当てるのに十分なオフスクリーンメモリがあるまで、またはドライバーがDDERR_OUTOFMEMORYを返すまで 、DdFreeDriverMemory を継続的に呼び出します。