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

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