IDirectDrawSurface7::AddAttachedSurface メソッド (ddraw.h)

指定した z バッファー サーフェスをこのサーフェスにアタッチします。

構文

HRESULT AddAttachedSurface(
  [in] LPDIRECTDRAWSURFACE7 unnamedParam1
);

パラメーター

[in] unnamedParam1

アタッチするサーフェスの IDirectDrawSurface7 インターフェイスのアドレス。

戻り値

メソッドが成功した場合、戻り値はDD_OK。

失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。

• DDERR_CANNOTATTACHSURFACE
• DDERR_GENERIC
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_SURFACEALREADYATTACHED
• DDERR_SURFACELOST
• DDERR_WASSTILLDRAWING

注釈

AddAttachedSurface は、アタッチされているサーフェスの参照カウントをインクリメントします。 IDirectDrawSurface7::D eleteAttachedSurface メソッドを使用して、サーフェスを明示的にアタッチ解除し、その参照カウントをデクリメントできます。 IDirectDraw7::CreateSurface を 1 回呼び出して作成する複雑なサーフェスとは異なり、このメソッドでアタッチされたサーフェスは自動的には解放されません。 アプリケーションは、このようなサーフェスを解放する必要があります。

このメソッドでは、z バッファー サーフェスのみをアタッチできます。

要件

こちらもご覧ください

IDirectDrawSurface7