Fonction DrvCopyBits (winddi.h)

  • Article

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)

Voir aussi

CLIPOBJ

XLATEOBJ