PDD_SURFCB_UPDATEOVERLAY

DdUpdateOverlay コールバック関数は、オーバーレイサーフェスの位置を変更したり、視覚的な属性を変更したりします。

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

DdUpdateOverlay は、画面上のオーバーレイサーフェスの表示、非表示、または再配置を行います。また、ストレッチ係数や使用するカラーキーの種類など、オーバーレイサーフェスの属性も設定します。

ドライバーは、オーバーレイの更新要求をサポートできるだけの帯域幅があるかどうかを判断する必要があります。ドライバーは、lpUpdateOverlay が指す DD_UPDATEOVERLAYDATA 構造体の dwFlags メンバーを使用して、要求の種類とその処理方法を判断する必要があります。

DD_UPDATEOVERLAYDATA の rDest メンバーと rSrc メンバーで指定される四角形のサイズが異なる場合、ドライバーおよびハードウェアは、それに応じてオーバーレイを拡大または縮小する必要があります。

オーバーレイサーフェス間のフリップには DdFlip が使用されるため、DdUpdateOverlay のパフォーマンスは重要ではないことに注意してください。