ホーム › Devices.Display › PFN_DrvSynchronizeSurface
PFN_DrvSynchronizeSurface
コールバックシグネチャ
void PFN_DrvSynchronizeSurface(
SURFOBJ* param0,
RECTL* param1,
DWORD param2
);パラメーター
| フィールド | 型 |
|---|---|
| param0 | SURFOBJ* |
| param1 | RECTL* |
| param2 | DWORD |
公式ドキュメント
DrvSynchronizeSurface 関数は、GDI が指定されたサーフェスへの書き込みを必要としていることをドライバーに通知します。この関数により、デバイスのコプロセッサーが実行する描画操作を GDI と協調させることができます。
解説(Remarks)
この関数により、デバイスのコプロセッサーが実行する描画操作を GDI と協調させることができます。
DrvSynchronizeSurface は、ディスプレイドライバーで任意に実装できます。GDI がこの関数を呼び出すのは、EngAssociateSurface によってフックされている場合のみです。GDI は、デバイスサーフェスへ直接描画する直前に DrvSynchronizeSurface を呼び出します。
DrvSynchronizeSurface は、描画にコプロセッサーを使用するデバイスをサポートすることを目的としています。そのようなデバイスは、長時間かかる描画操作を開始し、その操作が続いている間に GDI へ制御を返すことができます。デバイスドライバーがサーフェスに対するすべての描画操作を実行するわけではない場合、後続の描画操作が GDI によって処理される可能性があります。この場合、GDI がサーフェスに描画する前に、コプロセッサーが処理を完了するのを GDI が待つ必要があります。
この関数は、prcl で指定された矩形領域内のサーフェスに GDI が安全に描画できる状態になった時点で戻る必要があります。
DrvSynchronizeSurface 自体は出力関数ではありません。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)