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 に次のいずれかの値が設定される。