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) |