英語で読む

次の方法で共有

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 バッファー サーフェスのみをアタッチできます。

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ddraw.h
ライブラリ Ddraw.lib
DLL Ddraw.dll

関連項目

IDirectDrawSurface7 の