Função DrvCopyBits (winddi.h)

A função DrvCopyBits é convertida entre superfícies de raster gerenciadas pelo dispositivo e bitmaps de formato padrão GDI.

Sintaxe

BOOL DrvCopyBits(
  SURFOBJ  *psoDest,
  SURFOBJ  *psoSrc,
  CLIPOBJ  *pco,
  XLATEOBJ *pxlo,
  RECTL    *prclDest,
  POINTL   *pptlSrc
);

Parâmetros

psoDest

Ponteiro para a estrutura SURFOBJ de destino para a operação de cópia.

psoSrc

Ponteiro para a estrutura SURFOBJ de origem para a operação de cópia.

pco

Ponteiro para uma estrutura CLIPOBJ que define uma região de clipe na superfície de destino.

pxlo

Ponteiro para uma estrutura XLATEOBJ que define a tradução de índices de cores entre as superfícies de origem e de destino. Se pxlo for NULL, nenhuma tradução será necessária.

prclDest

Ponteiro para uma estrutura RECTL que define a área a ser modificada. Essa estrutura usa o sistema de coordenadas da superfície de destino. As bordas inferior e direita desse retângulo não fazem parte da transferência de bloco de bits, o que significa que o retângulo é exclusivo inferior direito.

DrvCopyBits nunca é chamado com um retângulo de destino vazio. Os dois pontos que definem o retângulo são sempre bem ordenados.

pptlSrc

Ponteiro para uma estrutura POINTL que define o canto superior esquerdo do retângulo de origem.

Retornar valor

O valor retornado será TRUE se a superfície de origem for copiada com êxito para a superfície de destino.

Comentários

Opcionalmente, o driver pode enganchar DrvCopyBits. Nesse caso, a GDI chamará DrvCopyBits quando precisar copiar de uma superfície para outra e pelo menos uma das superfícies for gerenciada pelo dispositivo.

Requisitos

Confira também

CLIPOBJ

XLATEOBJ