Platform SDK: DirectX

IDirectDrawSurface7::GetAttachedSurface

IDirectDrawSurface7::GetAttachedSurface メソッドは、指定した能力を持つアタッチされたサーフェスを取得し、取得したインターフェイスの参照カウントをインクリメントする。

HRESULT GetAttachedSurface(
  LPDDSCAPS2 lpDDSCaps, 
  LPDIRECTDRAWSURFACE7 FAR *lplpDDAttachedSurface  
);

パラメータ

lpDDSCaps
サーフェスのハードウェア能力を含む DDSCAPS2 構造体のアドレス。
lplpDDAttachedSurface
取得するサーフェスの IDirectDrawSurface7 インターフェイスへのポインタを受け取る変数のアドレス。取得するサーフェスは、lpDDSCaps パラメータの記述に適合するものである。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOTFOUND
DDERR_SURFACELOST

注意

アタッチは、複数の DirectDrawSurface オブジェクトを複合構造体に接続するために使用される。複合構造体とは、たとえば、Z バッファと共に 3D ページ フリッピングをサポートするために必要な構造体である。要求する能力に適合するアタッチされたサーフェスが 1 つ以上ある場合、このメソッドは失敗する。この場合、アプリケーションではアタッチされたサーフェスを取得するには、IDirectDrawSurface7::EnumAttachedSurfaces メソッドを使用しなければならない。

動作環境

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