IDirectDrawSurface7::GetAttachedSurface メソッド (ddraw.h)
指定した機能を持つアタッチされたサーフェスを取得し、取得したインターフェイスの参照カウントをインクリメントします。
構文
HRESULT GetAttachedSurface(
[in] LPDDSCAPS2 unnamedParam1,
[out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);
パラメーター
[in] unnamedParam1
アタッチされたサーフェスのハードウェア機能を示す DDSCAPS2 構造体へのポインター。
[out] unnamedParam2
取得したサーフェスの IDirectDrawSurface7 インターフェイスへのポインターを受け取る変数へのポインター。 取得されたサーフェスは、 lpDDSCaps パラメーターに従って、説明に一致するサーフェスです。
戻り値
メソッドが成功した場合、戻り値はDD_OK。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOTFOUND
- DDERR_SURFACELOST
注釈
添付ファイルは、Z バッファーを使用した 3-D ページ反転をサポートするために必要な複雑な構造のように、複数の DirectDrawSurface オブジェクトを複雑な構造に接続するために使用されます。 要求された機能に一致する複数のサーフェスがアタッチされている場合、GetAttachedSurface は失敗します。 この場合、アプリケーションは IDirectDrawSurface7::EnumAttachedSurfaces メソッドを使用して、アタッチされたサーフェスを取得する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | ddraw.h |
| Library | Ddraw.lib |
| [DLL] | Ddraw.dll |