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

Artículo
02/29/2024

La función D3dDestroyDDLocal destruye todas las superficies de Microsoft Direct3D creadas anteriormente por la función D3dCreateSurfaceEx que pertenecen al mismo objeto local de Microsoft DirectDraw determinado.

Sintaxis

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

Parámetros

unnamedParam1

Apunta a una estructura de DDHAL_DESTROYDDLOCALDATA que contiene la información necesaria para que el controlador destruya las superficies.

Valor devuelto

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

Comentarios

Todos los controladores de Direct3D deben admitir D3dDestroyDDDLocal.

Direct3D llama a D3dDestroyDDLocal cuando la aplicación indica que el contexto de Direct3D ya no es necesario y se destruirá junto con todas las superficies asociadas a él. La asociación pasa por el puntero al objeto DirectDraw local. El controlador debe liberar cualquier memoria que la devolución de llamada D3dCreateSurfaceEx del controlador haya asignado para cada superficie, si es necesario.

El controlador no debe destruir las superficies de DirectDraw asociadas a estas superficies de Direct3D. Esta es la responsabilidad de la aplicación.

Puntero a la estructura de DD_DIRECTDRAW_LOCAL que se pasó como miembro lpDDLcl de la estructura de D3DHAL_CONTEXTCREATEDATA cuando el sistema operativo lanzó D3dContextCreate después de que D3dDestroyDDDLocal devuelva.

Se puede llamar a D3dDestroyDDLocal con un PDEV deshabilitado. Un 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.