Compartir a través de

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

  • Artículo

Asocia la superficie z-buffer especificada a esta superficie.

Sintaxis

HRESULT AddAttachedSurface(
  [in] LPDIRECTDRAWSURFACE7 unnamedParam1
);

Parámetros

[in] unnamedParam1

Dirección de la interfaz IDirectDrawSurface7 para la superficie que se va a adjuntar.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es DD_OK.

Si se produce un error, el método puede devolver uno de los siguientes valores de error:

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

Comentarios

AddAttachedSurface incrementa el recuento de referencias de la superficie que se está adjuntando. Puede anular explícitamente la superficie y disminuir su recuento de referencias mediante el método IDirectDrawSurface7::D eleteAttachedSurface . A diferencia de las superficies complejas que se crean con una sola llamada a IDirectDraw7::CreateSurface, las superficies adjuntas a este método no se liberan automáticamente. La aplicación debe liberar estas superficies.

Solo puede adjuntar superficies de búfer z con este método.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado ddraw.h
Library Ddraw.lib
Archivo DLL Ddraw.dll

Consulte también

IDirectDrawSurface7