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 緩衝區翻轉 3D 頁面所需的複雜結構。 如果附加一個以上的表面符合所要求的功能，GetAttachedSurface 就會失敗。 在此情況下，應用程式必須使用 IDirectDrawSurface7：：EnumAttachedSurfaces 方法來取得附加表面。

規格需求

需求 值
目標平台 Windows
標頭 ddraw.h
程式庫 Ddraw.lib
Dll Ddraw.dll

另請參閱

IDirectDrawSurface7