Platform SDK: DirectX |
IDirectDrawSurface7::GetAttachedSurface メソッドは、指定した能力を持つアタッチされたサーフェスを取得し、取得したインターフェイスの参照カウントをインクリメントする。
HRESULT GetAttachedSurface( LPDDSCAPS2 lpDDSCaps, LPDIRECTDRAWSURFACE7 FAR *lplpDDAttachedSurface );
成功すれば、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 で宣言。