DrvEnableDirectDraw, fonction (winddi.h)

Article
08/27/2023

La fonction DrvEnableDirectDraw active le matériel pour l’utilisation de DirectDraw.

Syntaxe

BOOL DrvEnableDirectDraw(
  DHPDEV              dhpdev,
  DD_CALLBACKS        *pCallBacks,
  DD_SURFACECALLBACKS *pSurfaceCallBacks,
  DD_PALETTECALLBACKS *pPaletteCallBacks
);

Paramètres

dhpdev

Handle vers le PDEV retourné par la routine DrvEnablePDEV du pilote.

pCallBacks

Pointe vers la structure DD_CALLBACKS à initialiser par le pilote.

pSurfaceCallBacks

Pointe vers la structure DD_SURFACECALLBACKS à initialiser par le pilote.

pPaletteCallBacks

Pointe vers la structure DD_PALETTECALLBACKS à initialiser par le pilote.

Valeur retournée

DrvEnableDirectDraw retourne TRUE si elle réussit ; sinon, elle retourne FALSE.

Remarques

GDI appelle la fonction DrvEnableDirectDraw du pilote pour obtenir des pointeurs vers les rappels DirectDraw pris en charge par le pilote. Le pilote doit définir les membres de pointeur de fonction de DD_CALLBACKS, DD_SURFACECALLBACKS et DD_PALETTECALLBACKS pour qu’ils pointent vers les fonctions qu’il implémente. Un pilote doit également définir les champs de bits correspondants dans les membres dwFlags de ces structures pour tous les rappels pris en charge.

L’implémentation DrvEnableDirectDraw d’un pilote peut également dédier des ressources matérielles telles que la mémoire d’affichage pour une utilisation par DirectDraw uniquement.