IDirectDrawSurface7::EnumAttachedSurfaces メソッド (ddraw.h)
このサーフェスにアタッチされているすべてのサーフェスを列挙します。
構文
HRESULT EnumAttachedSurfaces(
[in] LPVOID unnamedParam1,
[in] LPDDENUMSURFACESCALLBACK7 unnamedParam2
);
パラメーター
[in] unnamedParam1
列挙メンバーが呼び出されるたびに渡されるアプリケーション定義構造体のアドレス。
[in] unnamedParam2
このサーフェスにアタッチされている各サーフェスに対して呼び出される EnumSurfacesCallback7 関数のアドレス。
戻り値
メソッドが成功した場合、戻り値はDD_OK。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_SURFACELOST
解説
EnumAttachedSurfaces は、 このサーフェスに直接接続されているサーフェスのみを列挙します。 たとえば、3 つ以上のサーフェスの反転チェーンでは、各サーフェスが反転チェーン内の次のサーフェスにのみアタッチされるため、1 つのサーフェスのみが列挙されます。 このような構成では、連続する各サーフェスで EnumAttachedSurfaces を呼び出して、反転チェーン全体を歩くことができます。
EnumAttachedSurfaces は、EnumSurfacesCallback または EnumSurfacesCallback2 関数ではなく、EnumSurfacesCallback7 関数へのポインターを受け入れるという点で、以前のインターフェイス バージョンでは対応するものとは異なります。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | ddraw.h |
| Library | Ddraw.lib |
| [DLL] | Ddraw.dll |