structure DD_UPDATEOVERLAYDATA (ddrawint.h)

La structure DD_UPDATEOVERLAYDATA contient les informations nécessaires à la mise à jour d’une surface de superposition.

Syntaxe

typedef struct _DD_UPDATEOVERLAYDATA {
  PDD_DIRECTDRAW_GLOBAL lpDD;
  PDD_SURFACE_LOCAL     lpDDDestSurface;
  RECTL                 rDest;
  PDD_SURFACE_LOCAL     lpDDSrcSurface;
  RECTL                 rSrc;
  DWORD                 dwFlags;
  DDOVERLAYFX           overlayFX;
  HRESULT               ddRVal;
  VOID                  *UpdateOverlay;
} *PDD_UPDATEOVERLAYDATA, DD_UPDATEOVERLAYDATA;

Membres

lpDD

Pointe vers une structure DD_DIRECTDRAW_GLOBAL qui décrit le périphérique du pilote.

lpDDDestSurface

Pointe vers une structure DD_SURFACE_LOCAL qui représente la surface Microsoft DirectDraw à superposer. Cette valeur peut être NULL si DDOVER_HIDE est spécifié dans dwFlags.

rDest

Spécifie une structure RECTL qui contient les valeurs x, y, width et height de la région sur la surface de destination à superposer.

lpDDSrcSurface

Pointe vers une structure DD_SURFACE_LOCAL qui décrit la surface de superposition.

rSrc

Spécifie une structure RECTL qui contient les valeurs x, y, largeur et hauteur de la région sur la surface source à utiliser pour la superposition.

dwFlags

Spécifie comment le pilote doit gérer la superposition. Ce membre peut être une combinaison de l’un des indicateurs suivants :

Indicateur	Signification
DDOVER_ADDDIRTYRECT	Doit être ignoré par le pilote.
DDOVER_AUTOFLIP	Le pilote doit automatiquement appliquer la superposition chaque fois que le port vidéo matériel est autoflips. Les pilotes qui prennent en charge les extensions de port vidéo (VPE) n’ont besoin que case activée cet indicateur.
DDOVER_BOB	Le pilote doit afficher chaque champ de données d’objet VPE individuellement sans provoquer d’artefacts instables. Cet indicateur concerne à la fois VPE et les décodeurs qui souhaitent effectuer leur propre basculement en mode noyau à l’aide de la fonctionnalité de transport vidéo en mode noyau.
DDOVER_BOBHARDWARE	Indique que bob est effectué par le matériel plutôt que par le logiciel ou l’émulation. Les pilotes qui prennent en charge VPE n’ont besoin que case activée cet indicateur.
DDOVER_DDFX	Le pilote doit afficher la surface de superposition à l’aide des attributs spécifiés par le membre overlayFX .
DDOVER_HIDE	Le pilote doit masquer la superposition ; autrement dit, le pilote doit désactiver cette superposition.
DDOVER_INTERLEAVED	La surface de superposition est composée de champs entrelacés. Les pilotes qui prennent en charge VPE n’ont besoin que case activée cet indicateur.
DDOVER_KEYDEST	Le pilote doit utiliser la clé de couleur associée à la surface de destination.
DDOVER_KEYDESTOVERRIDE	Le pilote doit utiliser le membre dckDestColorKey de la structure DDOVERLAYFX (décrit dans la documentation du SDK DirectDraw) comme clé de couleur de destination au lieu de la clé de couleur associée à la surface de destination.
DDOVER_KEYSRC	Le pilote doit utiliser la clé de couleur associée à la surface de destination.
DDOVER_KEYSRCOVERRIDE	Le pilote doit utiliser le membre dckSrcColorKey de la structure DDOVERLAYFX (décrit dans la documentation du SDK DirectDraw) comme clé de couleur source au lieu de la clé de couleur associée à la surface de destination.
DDOVER_OVERRIDEBOBWEAVE	Les décisions bob/weave ne doivent pas être remplacées par d’autres interfaces. Si le mélangeur de superposition définit cet indicateur, DirectDraw n’autorise pas un pilote en mode noyau à utiliser la fonctionnalité de transport vidéo en mode noyau pour basculer le matériel entre le mode bob et le mode de tissage.
DDOVER_REFRESHALL	Doit être ignoré par le pilote.
DDOVER_REFRESHDIRTYRECTS	Doit être ignoré par le pilote.
DDOVER_SHOW	Le pilote doit afficher la superposition ; autrement dit, le pilote doit activer cette superposition.

overlayFX

Spécifie une structure DDOVERLAYFX (décrite dans la documentation du Kit de développement logiciel (SDK) DirectDraw qui décrit les effets supplémentaires que le pilote doit utiliser pour mettre à jour la superposition. Le pilote doit utiliser cette structure uniquement si l’un des DDOVER_DDFX, DDOVER_KEYDESTOVERRIDE ou DDOVER_KEYSRCOVERRIDE sont définis dans le membre dwFlags .

ddRVal

Spécifie l’emplacement dans lequel le pilote écrit la valeur de retour du rappel DdUpdateOverlay . Un code de retour de DD_OK indique la réussite. Pour plus d’informations, consultez Valeurs de retour pour DirectDraw.

UpdateOverlay

Utilisé par l’API DirectDraw et ne doit pas être renseigné par le pilote.

Spécifications

En-tête	ddrawint.h (incluez Winddi.h)

Voir aussi

DdUpdateOverlay