Platform SDK: DirectX

DirectDrawSurface7.UpdateOverlay

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

object.UpdateOverlay(RECT As RECT, _ 
    ddS As DirectDrawSurface7, _ 
    rectD As RECT, _ 
    flags As CONST_DDOVERFLAGS)

パラメータ

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

エラー コード

失敗すればエラーが発生し、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