Platform SDK: DirectX

IDirectDrawSurface7::EnumOverlayZOrders

IDirectDrawSurface7::EnumOverlayZOrders メソッドは、指定する転送先のオーバーレイ サーフェスを列挙する。オーバーレイは、フロントからバック、またはバックからフロントの順で列挙される。

HRESULT EnumOverlayZOrders(
  DWORD dwFlags,                          
  LPVOID lpContext,                       
  LPDDENUMSURFACESCALLBACK2 lpfnCallback  
);

パラメータ

dwFlags
以下のフラグのうち、1 つの値を取る。
DDENUMOVERLAYZ_BACKTOFRONT
バックからフロントの順でオーバーレイを列挙する。
DDENUMOVERLAYZ_FRONTTOBACK
フロントからバックの順でオーバーレイを列挙する。
lpContext
各オーバーレイ サーフェスのコールバック関数に渡す、ユーザー定義コンテキストのアドレス。
lpfnCallback
このサーフェスにオーバーレイされる各サーフェスに対して呼び出す、EnumSurfacesCallback2 コールバック関数のアドレス。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

このメソッドは以前のバージョンのインターフェイスの対応するメソッドとは異なり、EnumSurfacesCallback 関数よりも EnumSurfacesCallback2 関数へのポインタを受け取る。

動作環境

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