Platform SDK: DirectX

DirectDrawSurface7.UpdateOverlayFx

DirectDrawSurface7.UpdateOverlayFx メソッドは、特殊なオーバーレイ エフェクトを使って、オーバーレイ サーフェスに対するビジュアル属性を再配置したり変更する。これらのサーフェスには、DDSCAPS_OVERLAY フラグを設定する必要がある。

object.UpdateOverlayFx(RECT As RECT, _ 
    ddS As DirectDrawSurface7, _ 
    rectD As RECT, _ 
    flags As CONST_DDOVERFLAGS, _ 
    ddoverfx As DDOVERLAYFX)

パラメータ

object
DirectDrawSurface7 オブジェクトを表すオブジェクト式。
RECT
オーバーレイとして使用される転送元サーフェスの領域の x、y、幅、および高さを定義する RECT 型。このパラメータは、オーバーレイを隠蔽する場合や、オーバーレイ サーフェス全体を使用し、かつオーバーレイ サーフェスがデバイス ドライバからの境界およびサイズ アライメント制限にも従うことを示す場合に、空の RECT とする。
ddS
オーバーレイが行われるサーフェスに対する DirectDrawSurface7 オブジェクト。
rectD
オーバーレイを移動する転送先サーフェスの領域の x、y、幅、および高さを定義する RECT 型。このパラメータは、オーバーレイを隠蔽する場合に空の RECT となる。
flags
CONST_DDOVERFLAGS 列挙の 1 つまたは複数の定数。ddoverfx パラメータによって設定されたエフェクトを適用するには、DDOVER_DDFX フラグを指定しなければならない。
ddoverfx
オーバーレイ サーフェスに適用される追加のエフェクトを記述する DDOVERLAYFX 型。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_DEVICEDOESNTOWNSURFACE
DDERR_GENERIC
DDERR_HEIGHTALIGN
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_INVALIDSURFACETYPE
DDERR_NOSTRETCHHW
DDERR_NOTAOVERLAYSURFACE
DDERR_OUTOFCAPS
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_XALIGN