EngTransparentBlt-Funktion (winddi.h)

Artikel
08/27/2023

Die EngTransparentBlt-Funktion bietet Bitblockübertragungsfunktionen mit Transparenz.

Syntax

ENGAPI BOOL EngTransparentBlt(
  [in]           SURFOBJ  *psoDst,
  [in]           SURFOBJ  *psoSrc,
  [in, optional] CLIPOBJ  *pco,
  [in, optional] XLATEOBJ *pxlo,
  [in]           RECTL    *prclDst,
  [in]           RECTL    *prclSrc,
  [in]           ULONG    TransColor,
  [in]           ULONG    bCalledFromBitBlt
);

Parameter

[in] psoDst

Zeiger auf die SURFOBJ-Struktur , die die Zieloberfläche identifiziert, auf der gezeichnet werden soll.

[in] psoSrc

Zeiger auf die SURFOBJ-Struktur, die die Quelloberfläche der Bitblockübertragung identifiziert.

[in, optional] pco

Zeiger auf eine CLIPOBJ-Struktur . Die CLIPOBJ_Xxx-Dienstroutinen werden bereitgestellt, um den Clipbereich als Eine Reihe von Rechtecken aufzulisten. Diese Enumeration schränkt den Bereich des geänderten Ziels ein. Wann immer möglich, vereinfacht GDI den Ausschnitt.

[in, optional] pxlo

Zeiger auf eine XLATEOBJ-Struktur , die angibt, wie die Quellfarbindizes für das Schreiben auf die Zieloberfläche übersetzt werden sollen.

[in] prclDst

Zeiger auf eine RECTL-Struktur , die den zu ändernden rechteckigen Bereich definiert. Dieses Rechteck wird im Koordinatensystem der Zieloberfläche angegeben und durch zwei Punkte definiert: links oben und unten rechts. Das Rechteck ist unten rechts exklusiv; Das heißt, die unteren und rechten Ränder sind kein Teil der Bitblockübertragung. Die beiden Punkte, die das Rechteck definieren, sind immer gut sortiert.

Der Treiber darf EngTransparentBlt niemals mit einem leeren Zielrechteck aufrufen.

[in] prclSrc

Zeiger auf eine RECTL-Struktur, die den zu kopierenden rechteckigen Bereich definiert. Dieses Rechteck wird im Koordinatensystem der Quelloberfläche angegeben und durch zwei Punkte definiert: links oben und unten rechts. Die beiden Punkte, die das Rechteck definieren, sind immer gut sortiert.

Das Quellrechteck überschreitet nie die Grenzen der Quelloberfläche und überragt daher nie die Quelloberfläche.

Dieses Rechteck wird dem zielrechteck zugeordnet, das von prclDst definiert ist. Der Treiber darf EngTransparentBlt niemals mit einem leeren Quellrechteck aufrufen.

[in] TransColor

Gibt die physische transparente Farbe im Format der Quelloberfläche an. Dies ist ein Farbindexwert, der in die Palette der Quelloberfläche übersetzt wurde. Weitere Informationen finden Sie im Abschnitt Hinweise.

[in] bCalledFromBitBlt

Reserviert. Dieser Parameter muss auf 0 festgelegt werden.

Rückgabewert

EngTransparentBlt gibt bei Erfolg TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

Der Treiber sollte EngTransparentBlt aufrufen, wenn er DrvTransparentBlt eingebunden hat und aufgerufen wird, um etwas zu tun, das er nicht unterstützt.

Die Bitblockübertragung mit Transparenz wird zwischen zwei geräteverwalteten Oberflächen oder zwischen einer geräteverwalteten Oberfläche und einer von GDI verwalteten Standardformat-Bitmap unterstützt. Derzeit unterstützt GDI nur BMF_4BPP und BMF_8BPP Quelloberflächen.

Die Pixel auf der Quelloberfläche, die der durch iTransparentColor angegebenen transparenten Farbe entsprechen, werden nicht kopiert. Eine ausführliche Erläuterung transparenter Blts finden Sie unter Kopieren von Bitmaps.

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