Win32 API 日本語リファレンス
ホーム › Graphics.DirectDraw › PDD_FREEDRIVERMEMORY

PDD_FREEDRIVERMEMORY

コールバック

シグネチャ

DWORD PDD_FREEDRIVERMEMORY(
    DD_FREEDRIVERMEMORYDATA* param0
);

パラメーター

フィールド型説明
param0DD_FREEDRIVERMEMORYDATA*解放要求の詳細を格納する DD_FREEDRIVERMEMORYDATA 構造体を指します。

公式ドキュメント

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

戻り値

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

解説(Remarks)

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

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

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)