PDD_SURFCB_UPDATEOVERLAY fonction de rappel (ddrawint.h)

Article
08/23/2023

La fonction de rappel DdUpdateOverlay repositionne ou modifie les attributs visuels d’une surface de superposition.

Syntaxe

PDD_SURFCB_UPDATEOVERLAY PddSurfcbUpdateoverlay;

DWORD PddSurfcbUpdateoverlay(
  PDD_UPDATEOVERLAYDATA unnamedParam1
)
{...}

Paramètres

unnamedParam1

Pointe vers une structure DD_UPDATEOVERLAYDATA qui contient les informations requises pour mettre à jour la superposition.

Valeur retournée

DdUpdateOverlay retourne l’un des codes de rappel suivants :

Notes

DdUpdateOverlay affiche, masque ou repositionne une surface superposée à l’écran. Il définit également les attributs de la surface de superposition, tels que le facteur d’étirement ou le type de clé de couleur à utiliser.

Le pilote doit déterminer s’il dispose de la bande passante nécessaire pour prendre en charge la demande de mise à jour de superposition. Le pilote doit utiliser le membre dwFlags de la structure DD_UPDATEOVERLAYDATA sur lpUpdateOverlay pour déterminer le type de requête et la façon de la traiter.

Le pilote/matériel doit étirer ou réduire la superposition en conséquence lorsque les rectangles spécifiés par les membres rDest et rSrc de DD_UPDATEOVERLAYDATA ont des tailles différentes.

Notez que DdFlip est utilisé pour basculer entre les surfaces de superposition, de sorte que les performances de DdUpdateOverlay ne sont pas critiques.