EngTransparentBlt-Funktion (winddi.h)
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 |