Platform SDK: DirectX

IDirectDrawSurface7::EnumAttachedSurfaces

IDirectDrawSurface7::EnumAttachedSurfaces メソッドは、与えられたサーフェスにアタッチされるすべてのサーフェスを列挙する。

HRESULT EnumAttachedSurfaces(
  LPVOID lpContext,                                
  LPDDENUMSURFACESCALLBACK2 lpEnumSurfacesCallback  
);

パラメータ

lpContext
呼び出しのたびに列挙メンバに渡す、アプリケーション定義構造体のアドレス。
lpEnumSurfacesCallback
このサーフェスにアタッチされる各サーフェスに対して呼び出す EnumSurfacesCallback2 関数のアドレス。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_SURFACELOST

注意

このメソッドは、このサーフェスに直接アタッチされたサーフェスだけを列挙する。たとえば、3 つ以上のサーフェスのフリッピング チェーンでは、個々のサーフェスがフリッピング チェーンの次のサーフェスにのみアタッチされるので、1 つのサーフェスのみ列挙される。このような構成では、個々の連続するサーフェス上で EnumAttachedSurfaces を呼び出すと、フリッピング チェーン全体を見ることができる。

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

動作環境

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