PDD_SURFCB_DESTROYSURFACE función de devolución de llamada (ddrawint.h)

Artículo
08/23/2023

La función de devolución de llamada DdDestroySurface destruye una superficie de DirectDraw.

Sintaxis

PDD_SURFCB_DESTROYSURFACE PddSurfcbDestroysurface;

DWORD PddSurfcbDestroysurface(
  PDD_DESTROYSURFACEDATA unnamedParam1
)
{...}

Parámetros

unnamedParam1

Apunta a una estructura DD_DESTROYSURFACEDATA que contiene la información necesaria para destruir una superficie.

Valor devuelto

DdDestroySurface devuelve uno de los siguientes códigos de devolución de llamada:

Comentarios

Si DirectDraw realizó la asignación de memoria en el momento de la creación de la superficie y el controlador no estaba implicado en la asignación, DirectDraw no llama a la función DdDestroySurface del controlador para destruir la superficie.

Si el controlador realiza la propia administración de memoria de la superficie, DdDestroySurface debe liberar la memoria de la superficie y realizar cualquier otra limpieza, como liberar datos privados almacenados en los miembros dwReserved1 de las estructuras de DD_SURFACE_GLOBAL y DD_SURFACE_LOCAL .

Para una superficie administrada por el controlador, si la superficie es persistente (es decir, se puede llamar a la marca de DDSCAPS2_DONOTPERSIST en el miembro dwCaps2 de la estructura DDSCAPS2 de la superficie), se puede llamar a DdDestroySurface con el fin de expulsar la superficie de la memoria de vídeo. En este caso, el controlador de pantalla puede seguir manteniendo cualquier dato privado en los miembros dwReserved1 hasta que se llame a DdDestroySurface para destruir realmente la superficie.

Se puede llamar a DdDestroySurface con un PDEV deshabilitado. PDEV está deshabilitado o habilitado llamando a la función DrvAssertMode del controlador de pantalla. Consulte Administración de PDEV para obtener más información.