Fonction DrvCopyBits (winddi.h)
La fonction DrvCopyBits se traduit entre les surfaces raster gérées par l’appareil et les bitmaps au format standard GDI.
Syntaxe
BOOL DrvCopyBits(
SURFOBJ *psoDest,
SURFOBJ *psoSrc,
CLIPOBJ *pco,
XLATEOBJ *pxlo,
RECTL *prclDest,
POINTL *pptlSrc
);
Paramètres
psoDest
Pointeur vers la structure SURFOBJ de destination pour l’opération de copie.
psoSrc
Pointeur vers la structure SURFOBJ source pour l’opération de copie.
pco
Pointeur vers une structure CLIPOBJ qui définit une région de clip sur la surface de destination.
pxlo
Pointeur vers une structure XLATEOBJ qui définit la traduction d’index de couleur entre les surfaces source et cible. Si pxlo a la valeur NULL, aucune traduction n’est nécessaire.
prclDest
Pointeur vers une structure RECTL qui définit la zone à modifier. Cette structure utilise le système de coordonnées de la surface de destination. Les bords inférieur et droit de ce rectangle ne font pas partie du transfert de bloc binaire, ce qui signifie que le rectangle est exclusif en bas à droite.
DrvCopyBits n’est jamais appelé avec un rectangle de destination vide. Les deux points qui définissent le rectangle sont toujours bien ordonnés.
pptlSrc
Pointeur vers une structure POINTL qui définit l’angle supérieur gauche du rectangle source.
Valeur retournée
La valeur de retour est TRUE si la surface source est correctement copiée vers l’aire de destination.
Remarques
Le pilote peut éventuellement crocheter DrvCopyBits. Si tel est le cas, GDI appelle DrvCopyBits lorsqu’il doit effectuer une copie d’une surface vers une autre et qu’au moins une des surfaces est gérée par l’appareil.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | winddi.h (inclure Winddi.h) |