通过

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 创建的复杂图面不同，使用此方法附加的图面不会自动释放。 应用程序必须释放此类图面。

使用此方法只能附加 z 缓冲区图面。

要求

要求 值
目标平台 Windows
标头 ddraw.h
Library Ddraw.lib
DLL Ddraw.dll

另请参阅

IDirectDrawSurface7