EngCopyBits-Funktion (winddi.h)
Die EngCopyBits-Funktion übersetzt zwischen geräteverwalteten Rasteroberflächen und GDI-Bitmaps im Standardformat.
Syntax
ENGAPI BOOL EngCopyBits(
SURFOBJ *psoDest,
SURFOBJ *psoSrc,
CLIPOBJ *pco,
XLATEOBJ *pxlo,
[in] RECTL *prclDest,
[in] POINTL *pptlSrc
);
Parameter
psoDest
Zeiger auf eine SURFOBJ-Struktur , die die Zieloberfläche für den Kopiervorgang beschreibt.
psoSrc
Zeiger auf eine SURFOBJ-Struktur, die die Quelloberfläche für den Kopiervorgang beschreibt.
pco
Zeiger auf eine CLIPOBJ-Struktur , die den betroffenen Bereich der Zieloberfläche einschränkt. Dieser Parameter kann NULL sein.
pxlo
Zeiger auf eine XLATEOBJ-Struktur , die die Übersetzung von Farbindizes zwischen der Quell- und Zieloberfläche definiert.
[in] prclDest
Zeiger auf eine RECTL-Struktur , die den Bereich im Koordinatensystem der Zieloberfläche definiert, die geändert wird. Das Rechteck ist unten rechts exklusiv, d. h. die unteren und rechten Ränder dieses Rechtecks sind nicht Teil der Kopie.
[in] pptlSrc
Zeiger auf eine POINTL-Struktur , die die obere linke Ecke des Quellrechtecks definiert.
Rückgabewert
Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. Wenn es nicht erfolgreich ist, wird ein Fehler protokolliert und FALSE zurückgegeben.
Hinweise
Bitmaps im Standardformat sind einstufiges, gepacktes Pixelformat. Jede Scanlinie wird an einer 4-Byte-Grenze ausgerichtet. Diese Bitmaps haben 1, 4, 8, 16, 24 oder 32 Bits pro Pixel. Eine Liste der Standardformattypen finden Sie in der EngCreateBitmap-Funktion .
GDI ruft diese Funktion aus seinen Simulationen auf.
EngCopyBits sollte nicht mit einem leeren Zielrechteck aufgerufen werden, und die beiden Punkte des Zielrechtecks müssen gut sortiert sein. Das heißt, der erste Punkt sollte den oberen linken Scheitelpunkt des Rechtecks darstellen, und der zweite sollte den unteren rechten Scheitelpunkt darstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | winddi.h (einschließlich Winddi.h) |
| Bibliothek | Win32k.lib |
| DLL | Win32k.sys |