Platform SDK: DirectX

DirectDraw7.GetSurfacesEnum

DirectDraw7.GetSurfacesEnum メソッドは、DirectDraw7 オブジェクトにアタッチされたサーフェスの列挙に使用される DirectDrawEnumSurfaces オブジェクトを返す。

object.GetSurfacesEnum( _ 
    flags As CONST_DDENUMSURFACESFLAGS, _ 
    desc As DDSURFACEDESC2) As DirectDrawEnumSurfaces

パラメータ

object
DirectDraw7 オブジェクトを表すオブジェクト式。
flags
1 つの検索型フラグと 1 つの適業フラグの組み合わせを含む CONST_DDENUMSURFACESFLAGS 列挙。検索型フラグは、メソッドが適合フラグを検索する方法を決定する。つまり、desc パラメータの記述を使用して作成されるサーフェスを検索したり、既にその記述に適合する既存のサーフェスを検索できる。適合フラグは、メソッドがすべてのサーフェス、適合するサーフェスだけ、または desc パラメータの記述に適合しないサーフェスだけを列挙するかどうかを決定する。
desc
対象となるサーフェスを定義する DDSURFACEDESC2 型。

戻り値

成功すれば、DirectDrawEnumSurfaces オブジェクトを返す。このオブジェクトを使って、アタッチされたサーフェスの記述を照会できる。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
E_OUTOFMEMORY

注意

DDENUMSURFACES_CANBECREATED フラグを設定する場合、このメソッドは検索基準に合うサーフェスを一時的に作成しようとする。