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

  • Artículo

Obtiene la superficie adjunta que tiene las funcionalidades especificadas e incrementa el recuento de referencias de la interfaz recuperada.

Sintaxis

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

Parámetros

[in] unnamedParam1

Puntero a una estructura DDSCAPS2 que indica las funcionalidades de hardware de la superficie conectada.

[out] unnamedParam2

Puntero a una variable para recibir un puntero a la interfaz IDirectDrawSurface7 de la superficie recuperada. La superficie recuperada es la que coincide con la descripción, según el parámetro lpDDSCaps .

Valor devuelto

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

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

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOTFOUND
  • DDERR_SURFACELOST

Comentarios

Los datos adjuntos se usan para conectar varios objetos DirectDrawSurface a estructuras complejas, como las estructuras complejas necesarias para admitir el volteo de página 3D con búferes z. GetAttachedSurface produce un error si hay más de una superficie conectada que coincida con las funcionalidades solicitadas. En este caso, la aplicación debe usar el método IDirectDrawSurface7::EnumAttachedSurfaces para obtener las superficies adjuntas.

Requisitos

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

Consulte también

IDirectDrawSurface7