Compartilhar via

Método IDirectDrawSurface7::AddAttachedSurface (ddraw.h)

  • Artigo

Anexa a superfície de buffer z especificada a essa superfície.

Sintaxe

HRESULT AddAttachedSurface(
  [in] LPDIRECTDRAWSURFACE7 unnamedParam1
);

Parâmetros

[in] unnamedParam1

Endereço da interface IDirectDrawSurface7 para a superfície a ser anexada.

Retornar valor

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

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

Comentários

AddAttachedSurface incrementa a contagem de referência da superfície que está sendo anexada. Você pode desanexar explicitamente a superfície e diminuir sua contagem de referência usando o método IDirectDrawSurface7::D eleteAttachedSurface . Ao contrário das superfícies complexas que você cria com uma única chamada para IDirectDraw7::CreateSurface, as superfícies anexadas a esse método não são liberadas automaticamente. O aplicativo deve liberar essas superfícies.

Você pode anexar apenas superfícies de buffer z com esse método.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho ddraw.h
Biblioteca Ddraw.lib
DLL Ddraw.dll

Confira também

IDirectDrawSurface7