PDD_DESTROYDDLOCAL fonction de rappel (ddrawint.h)

Article
02/26/2024

La fonction D3dDestroyDDLocal détruit toutes les surfaces Microsoft Direct3D précédemment créées par la fonction D3dCreateSurfaceEx qui appartiennent au même objet Microsoft DirectDraw local donné.

Syntaxe

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

Paramètres

unnamedParam1

Pointe vers une structure DDHAL_DESTROYDDLOCALDATA qui contient les informations requises pour que le pilote détruise les surfaces.

Valeur retournée

D3dDestroyDDLocal retourne l’un des codes de rappel suivants :

Remarques

Tous les pilotes Direct3D doivent prendre en charge D3dDestroyDDLocal.

Direct3D appelle D3dDestroyDDLocal lorsque l’application indique que le contexte Direct3D n’est plus nécessaire et qu’il sera détruit avec toutes les surfaces qui lui sont associées. L’association passe par le pointeur vers l’objet DirectDraw local. Le pilote doit libérer toute mémoire que le rappel D3dCreateSurfaceEx du pilote a allouée pour chaque surface, si nécessaire.

Le pilote ne doit pas détruire les surfaces DirectDraw associées à ces surfaces Direct3D. Il s’agit de la responsabilité de l’application.

Le pointeur vers la structure DD_DIRECTDRAW_LOCAL qui a été passée en tant que membre lpDDLcl de la structure D3DHAL_CONTEXTCREATEDATA lorsque D3dContextCreate a été appelé est libéré par le système d’exploitation après le retour de D3dDestroyDDLocal .

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