LPD3DHAL_CONTEXTDESTROYCB función de devolución de llamada (d3dhal.h)

Artículo
08/07/2023

La función D3dContextDestroy elimina el contexto especificado.

Sintaxis

LPD3DHAL_CONTEXTDESTROYCB Lpd3dhalContextdestroycb;

DWORD Lpd3dhalContextdestroycb(
  LPD3DHAL_CONTEXTDESTROYDATA unnamedParam1
)
{...}

Parámetros

unnamedParam1

pcdd [in]

Apunta a una estructura D3DHAL_CONTEXTDESTROYDATA que contiene la información necesaria para que el controlador destruya el contexto.

Valor devuelto

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

Comentarios

Todos los controladores de Microsoft Direct3D deben admitir D3dContextDestroy.

El controlador debe liberar todos los recursos asignados al contexto que se está eliminando. Por ejemplo, el controlador debe liberar los siguientes recursos asociados al contexto:

Recursos de texturas
Sombreadores de vértices y píxeles
Declaraciones y código para sombreadores de vértices
Recursos para consultas asincrónicas

El controlador no debe liberar las superficies de Microsoft DirectDraw asociadas al contexto, ya que DirectDraw los liberará en respuesta a una solicitud en tiempo de ejecución de Direct3D o a una aplicación.

Si el controlador almacena en caché el puntero a la estructura DD_DIRECTDRAW_LOCAL que se pasó como miembro lpDDLcl de la estructura D3DHAL_CONTEXTCREATEDATA cuando se llamó a D3dContextCreate , el puntero podría no ser válido antes de llamar a D3dContextDestroy . Por lo tanto, D3dContextDestroy no debe desreferenciar este puntero DD_DIRECTDRAW_LOCAL porque una infracción de acceso puede dar lugar o devolver datos aleatorios. Por ejemplo, si se llama a la función D3dDestroyDDLocal del controlador antes de D3dContextDestroy, el sistema operativo libera este puntero DD_DIRECTDRAW_LOCAL antes de la llamada D3dContextDestroy .

Se puede llamar a D3dContextDestroy 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.