Platform SDK: DirectX |
IDirectDraw7::EnumSurfaces メソッドは、指定されたサーフェス記述を満たす、既存のまたは可能なサーフェスをすべて列挙する。
HRESULT EnumSurfaces( DWORD dwFlags, LPDDSURFACEDESC2 lpDDSD2, LPVOID lpContext, LPDDENUMSURFACESCALLBACK2 lpEnumSurfacesCallback );
検索タイプ フラグ
適合フラグ
成功すれば、DD_OK を返す。
失敗すれば、以下のエラー値のいずれかを返す。
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDENUMSURFACES_CANBECREATED フラグを設定する場合、このメソッドは検索基準に合うサーフェスを一時的に作成しようとする。
DDENUMSURFACES_DOESEXIST フラグを使用している場合、列挙されるサーフェスの参照カウント がインクリメントされる。そのサーフェスを使用しない場合は、個々の列挙の後に、IDirectDrawSurface7::Release を使用してサーフェスを解放しなければならない。サーフェスを使用する場合は、そのサーフェスが不要になったときに解放する。
このメソッドは以前のバージョンのインターフェイスの対応するメソッドとは異なり、EnumSurfacesCallback 関数よりも EnumSurfacesCallback2 関数へのポインタを受け取る。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 98 が必要。
ヘッダー : ddraw.h で宣言。