Funzione DrvCopyBits (winddi.h)

La funzione DrvCopyBits converte tra superfici raster gestite dal dispositivo e bitmap in formato standard GDI.

Sintassi

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

Parametri

psoDest

Puntatore alla struttura SURFOBJ di destinazione per l'operazione di copia.

psoSrc

Puntatore alla struttura SURFOBJ di origine per l'operazione di copia.

pco

Puntatore a una struttura CLIPOBJ che definisce un'area di ritaglio sulla superficie di destinazione.

pxlo

Puntatore a una struttura XLATEOBJ che definisce la conversione di indici di colore tra le superfici di origine e di destinazione. Se pxlo è NULL, non è necessaria alcuna traduzione.

prclDest

Puntatore a una struttura RECTL che definisce l'area da modificare. Questa struttura utilizza il sistema di coordinate della superficie di destinazione. I bordi inferiori e destro di questo rettangolo non fanno parte del trasferimento del blocco di bit, vale a dire che il rettangolo è inferiore destro esclusivo.

DrvCopyBits non viene mai chiamato con un rettangolo di destinazione vuoto. I due punti che definiscono il rettangolo sono sempre ordinati correttamente.

pptlSrc

Puntatore a una struttura POINTL che definisce l'angolo superiore sinistro del rettangolo di origine.

Valore restituito

Il valore restituito è TRUE se la superficie di origine viene copiata correttamente nell'area di destinazione.

Commenti

Il driver può eventualmente associare DrvCopyBits. In tal caso, GDI chiamerà DrvCopyBits quando deve essere copiata da una superficie a un'altra e almeno una delle superfici è gestita dal dispositivo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	winddi.h (include Winddi.h)

Vedi anche

CLIPOBJ

XLATEOBJ