Share via

EngCopyBits-Funktion (winddi.h)

  • Artikel

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

Weitere Informationen

CLIPOBJ

SURFOBJ

XLATEOBJ