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

  • Artículo

Restaura una superficie que se ha perdido. Esto ocurre cuando se libera la memoria expuesta asociada al objeto DirectDrawSurface.

Sintaxis

HRESULT Restore();

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_GENERIC
  • DDERR_IMPLICITLYCREATED
  • DDERR_INCOMPATIBLEPRIMARY
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOEXCLUSIVEMODE
  • DDERR_OUTOFMEMORY
  • DDERR_UNSUPPORTED
  • DDERR_WRONGMODE

Comentarios

La restauración restaura la memoria que se asignó para una superficie, pero no vuelve a cargar ningún mapa de bits que pudiera haber existido en la superficie antes de que se perdiera.

Las superficies se pueden perder porque se cambió el modo del adaptador de gráficos o porque una aplicación recibió acceso exclusivo al adaptador de gráficos y liberó toda la memoria expuesta asignada actualmente en el adaptador. Cuando un objeto DirectDrawSurface pierde su memoria expuesta, muchos métodos devuelven DDERR_SURFACELOST y no realizan ninguna otra función. El método IDirectDrawSurface7::Restore reasigna la memoria de superficie y la vuelve a asociar al objeto DirectDrawSurface.

Una sola llamada a Restore restaura las superficies implícitas asociadas de un objeto DirectDrawSurface (búferes de reserva, etc.). Un intento de restaurar una superficie creada implícitamente produce un error. La restauración no funciona en datos adjuntos explícitos creados mediante el método IDirectDrawSurface7::AddAttachedSurface ; cada una de estas superficies se debe restaurar individualmente.

Requisitos

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

Consulte también

IDirectDrawSurface7