PDD_SURFCB_DESTROYSURFACE fonction de rappel (ddrawint.h)

Article
08/23/2023

La fonction de rappel DdDestroySurface détruit une surface DirectDraw.

Syntaxe

PDD_SURFCB_DESTROYSURFACE PddSurfcbDestroysurface;

DWORD PddSurfcbDestroysurface(
  PDD_DESTROYSURFACEDATA unnamedParam1
)
{...}

Paramètres

unnamedParam1

Pointe vers une structure DD_DESTROYSURFACEDATA qui contient les informations nécessaires pour détruire une surface.

Valeur retournée

DdDestroySurface retourne l’un des codes de rappel suivants :

Notes

Si DirectDraw a alloué la mémoire au moment de la création de la surface et que le pilote n’était pas impliqué dans l’allocation, DirectDraw n’appelle pas la fonction DdDestroySurface du pilote pour détruire la surface.

Si le pilote effectue lui-même la gestion de la mémoire surface, DdDestroySurface doit libérer la mémoire de surface et effectuer tout autre nettoyage, par exemple libérer les données privées stockées dans les membres dwReserved1 des structures DD_SURFACE_GLOBAL et DD_SURFACE_LOCAL .

Pour une surface gérée par le pilote, si la surface est persistante (autrement dit, l’indicateur DDSCAPS2_DONOTPERSIST dans le membre dwCaps2 de la structure DDSCAPS2 pour la surface n’est pas défini), DdDestroySurface peut être appelé dans le but de supprimer la surface de la mémoire vidéo. Dans ce cas, le pilote d’affichage peut continuer à conserver toutes les données privées dans les membres dwReserved1 jusqu’à ce que DdDestroySurface soit appelé pour détruire réellement la surface.

DdDestroySurface peut être appelé avec un PDEV désactivé. PDEV est désactivé ou activé en appelant la fonction DrvAssertMode du pilote d’affichage. Pour plus d’informations, consultez Gestion des PDEVs .