Funzione EngCopyBits (winddi.h)
La funzione EngCopyBits converte tra superfici raster gestite dal dispositivo e bitmap in formato standard GDI.
Sintassi
ENGAPI BOOL EngCopyBits(
SURFOBJ *psoDest,
SURFOBJ *psoSrc,
CLIPOBJ *pco,
XLATEOBJ *pxlo,
[in] RECTL *prclDest,
[in] POINTL *pptlSrc
);
Parametri
psoDest
Puntatore a una struttura SURFOBJ che descrive la superficie di destinazione per l'operazione di copia.
psoSrc
Puntatore a una struttura SURFOBJ che descrive la superficie di origine per l'operazione di copia.
pco
Puntatore a una struttura CLIPOBJ che limita l'area della superficie di destinazione che verrà interessata. Questo parametro può essere NULL.
pxlo
Puntatore a una struttura XLATEOBJ che definisce la conversione di indici di colore tra le superfici di origine e di destinazione.
[in] prclDest
Puntatore a una struttura RECTL che definisce l'area nel sistema di coordinate della superficie di destinazione che verrà modificata. Il rettangolo è esclusivo in basso a destra, ovvero i bordi inferiore e destro di questo rettangolo non fanno parte della copia.
[in] pptlSrc
Puntatore a una struttura POINTL che definisce l'angolo superiore sinistro del rettangolo di origine.
Valore restituito
Il valore restituito è TRUE se la funzione ha esito positivo. Se ha esito negativo, registra un errore e restituisce FALSE.
Commenti
Le bitmap in formato standard sono in formato a piano singolo e in pixel compresso. Ogni linea di analisi è allineata su un limite di 4 byte. Queste bitmap hanno 1, 4, 8, 16, 24 o 32 bit per pixel. Per un elenco di tipi di formato standard, vedere la funzione EngCreateBitmap .
GDI chiama questa funzione dalle simulazioni.
EngCopyBits non deve essere chiamato con un rettangolo di destinazione vuoto e i due punti del rettangolo di destinazione devono essere ordinati correttamente; ovvero, il primo punto deve rappresentare il vertice superiore sinistro del rettangolo e il secondo deve rappresentare il vertice inferiore destro.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |