Méthode IDirectDrawSurface7 ::UpdateOverlay (ddraw.h)
Repositionne ou modifie les attributs visuels d’une surface de superposition. L’indicateur DDSCAPS_OVERLAY doit être défini sur ces surfaces.
Syntaxe
HRESULT UpdateOverlay(
[in] LPRECT unnamedParam1,
[in] LPDIRECTDRAWSURFACE7 unnamedParam2,
[in] LPRECT unnamedParam3,
[in] DWORD unnamedParam4,
[in] LPDDOVERLAYFX unnamedParam5
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure RECT qui définit les valeurs x, y, largeur et hauteur de la région sur la surface source utilisée comme superposition. Ce paramètre peut être NULL pour masquer une superposition ou pour indiquer que la surface de superposition entière doit être utilisée et que la surface de superposition est conforme à toutes les restrictions de limite et d’alignement de taille imposées par le pilote de périphérique.
[in] unnamedParam2
Pointeur vers l’interface IDirectDrawSurface7 pour l’objet DirectDrawSurface en cours de superposition.
[in] unnamedParam3
Pointeur vers une structure RECT qui définit la largeur, x et la hauteur, y, de la région sur la surface de destination vers laquelle la superposition doit être déplacée. Ce paramètre peut être NULL pour masquer la superposition.
[in] unnamedParam4
Combinaison des indicateurs suivants qui déterminent la mise à jour de superposition :
DDOVER_ADDDIRTYRECT
Ajoute un rectangle sale à une surface de superposition émulée.
DDOVER_ALPHADEST
Obsolète.
DDOVER_ALPHADESTCONSTOVERRIDE
Utilise le membre dwAlphaDestConst de la structure DDOVERLAYFX comme canal alpha de destination pour cette superposition.
DDOVER_ALPHADESTNEG
Indique que la surface de destination devient plus transparente à mesure que la valeur alpha augmente (0 est opaque).
DDOVER_ALPHADESTSURFACEOVERRIDE
Utilise le membre lpDDSAlphaDest de la structure DDOVERLAYFX comme destination du canal alpha pour cette superposition.
DDOVER_ALPHAEDGEBLEND
Utilise le membre dwAlphaEdgeBlend de la structure DDOVERLAYFX comme canal alpha pour les bords de l’image qui bordent les couleurs de la clé de couleur.
DDOVER_ALPHASRC
Utilise les informations alpha au format pixel ou la surface du canal alpha attachée à la surface source comme canal alpha source pour cette superposition.
DDOVER_ALPHASRCCONSTOVERRIDE
Utilise le membre dwAlphaSrcConst de la structure DDOVERLAYFX comme canal alpha source pour cette superposition.
DDOVER_ALPHASRCNEG
Indique que la surface source devient plus transparente à mesure que la valeur alpha augmente (0 est opaque).
DDOVER_ALPHASRCSURFACEOVERRIDE
Utilise le membre lpDDSAlphaSrc de la structure DDOVERLAYFX comme source de canal alpha pour cette superposition.
DDOVER_ARGBSCALEFACTORS
Nouveauté de DirectX 7.0. Indique que la structure DDOVERLAYFX contient des facteurs de mise à l’échelle ARGB valides.
DDOVER_AUTOFLIP
Bascule automatiquement vers la surface suivante dans la chaîne de basculement chaque fois qu’un port vidéo VSYNC se produit.
DDOVER_BOB
Affiche chaque champ du flux vidéo entrelacé individuellement sans provoquer l’affichage d’artefacts.
DDOVER_BOBHARDWARE
Les opérations Bob sont effectuées à l’aide de matériel, plutôt qu’à l’aide de logiciels ou en cours d’émulation. Cet indicateur doit être utilisé avec l’indicateur DDOVER_BOB.
DDOVER_DDFX
Utilise les indicateurs FX de superposition dans le paramètre lpDDOverlayFx pour définir des effets de superposition spéciaux.
DDOVER_DEGRADEARGBSCALING
Nouveauté de DirectX 7.0. Les facteurs de mise à l’échelle ARGB peuvent être dégradés pour s’adapter aux fonctionnalités du pilote.
DDOVER_HIDE
Désactive cette superposition.
DDOVER_INTERLEAVED
La mémoire de surface est composée de champs entrelacés.
DDOVER_KEYDEST
Utilise la clé de couleur associée à la surface de destination.
DDOVER_KEYDESTOVERRIDE
Utilise le membre dckDestColorkey de la structure DDOVERLAYFX comme clé de couleur pour la surface de destination.
DDOVER_KEYSRC
Utilise la clé de couleur associée à la surface source.
DDOVER_KEYSRCOVERRIDE
Utilise le membre dckSrcColorkey de la structure DDOVERLAYFX comme clé de couleur pour la surface source.
DDOVER_OVERRIDEBOBWEAVE
Les décisions de bob et de tissage ne doivent pas être remplacées par d’autres interfaces.
DDOVER_REFRESHALL
Redessine la surface entière sur une surface émulée.
DDOVER_REFRESHDIRTYRECTS
Redessine tous les rectangles sale sur une surface émulée.
DDOVER_SHOW
Active cette superposition.
[in] unnamedParam5
Pointeur vers la structure DDOVERLAYFX qui décrit les effets à utiliser. Peut être NULL si l’indicateur DDOVER_DDFX n’est pas spécifié.
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_DEVICEDOESNTOWNSURFACE
- DDERR_GENERIC
- DDERR_HEIGHTALIGN
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDRECT
- DDERR_INVALIDSURFACETYPE
- DDERR_NOSTRETCHHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_OUTOFCAPS
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_XALIGN
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |