通过

IDirectDrawSurface7：：GetAttachedSurface 方法 (ddraw.h)

  • 项目

获取具有指定功能的附加图面，并递增检索到的接口的引用计数。

语法

HRESULT GetAttachedSurface(
  [in]  LPDDSCAPS2           unnamedParam1,
  [out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);

参数

[in] unnamedParam1

指向 DDSCAPS2 结构的指针，该结构指示附加图面的硬件功能。

[out] unnamedParam2

指向变量的指针，用于接收指向检索到图面的 IDirectDrawSurface7 接口的指针。 根据 lpDDSCaps 参数，检索到的图面是与说明匹配的图面。

返回值

如果方法成功，则返回值DD_OK。

如果失败，方法可能会返回以下错误值之一：

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOTFOUND
  • DDERR_SURFACELOST

注解

附件用于将多个 DirectDrawSurface 对象连接到复杂结构，例如支持使用 z 缓冲区进行三维翻页所需的复杂结构。 如果附加了多个与请求的功能匹配的图面，GetAttachedSurface 将失败。 在这种情况下，应用程序必须使用 IDirectDrawSurface7：：EnumAttachedSurfaces 方法来获取附加的图面。

要求

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

另请参阅

IDirectDrawSurface7