Platform SDK: DirectX

IDirectDrawSurface7::UpdateOverlayZOrder

IDirectDrawSurface7::UpdateOverlayZOrder メソッドは、オーバーレイの z オーダーを設定する。

HRESULT UpdateOverlayZOrder(
  DWORD dwFlags,                       
  LPDIRECTDRAWSURFACE7 lpDDSReference  
);

パラメータ

dwFlags
以下のフラグのうち、1 つの値を取る。
DDOVERZ_INSERTINBACKOF
このオーバーレイをオーバーレイ チェーンの参照オーバーレイの後ろに挿入する。
DDOVERZ_INSERTINFRONTOF
このオーバーレイをオーバーレイ チェーンの参照オーバーレイの前に挿入する。
DDOVERZ_MOVEBACKWARD
このオーバーレイをオーバーレイ チェーンの 1 つ後ろに移動する。
DDOVERZ_MOVEFORWARD
このオーバーレイをオーバーレイ チェーンの 1 つ前に移動する。
DDOVERZ_SENDTOBACK
このオーバーレイをオーバーレイ チェーンの後ろに移動する。
DDOVERZ_SENDTOFRONT
このオーバーレイをオーバーレイ チェーンの前に移動する。
lpDDSReference
オーバーレイ チェーンの相対位置として使用される DirectDraw サーフェスの IDirectDrawSurface7 構造体のアドレス。このパラメータは、DDOVERZ_INSERTINBACKOF および DDOVERZ_INSERTINFRONTOF だけのために必要とされる。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOTAOVERLAYSURFACE

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。

参照

IDirectDrawSurface7::EnumOverlayZOrders