EngCreateBitmap-Funktion (winddi.h)

  • Artikel

Die EngCreateBitmap-Funktion fordert von GDI an, eine Bitmap zu erstellen und zu verwalten.

Syntax

ENGAPI HBITMAP EngCreateBitmap(
       SIZEL sizl,
       LONG  lWidth,
  [in] ULONG iFormat,
  [in] FLONG fl,
  [in] PVOID pvBits
);

Parameter

sizl

Gibt eine SIZEL-Struktur an, deren Member die Breite und Höhe der zu erstellenden Bitmap in Pixel enthalten. Eine SIZEL-Struktur ist mit einer SIZE-Struktur identisch.

Wenn pvBits nicht NULL ist, sollte dieser Wert alle auf dem Gerät sichtbaren Pixel darstellen, sodass das Gerät Arbeitsspeicher außerhalb des Bildschirms beibehalten kann.

lWidth

Gibt die Zuordnungsbreite der Bitmap an. Dabei handelt es sich um die Anzahl der Bytes, die einem Zeiger hinzugefügt werden müssen, um eine Scanlinie nach unten zu bewegen.

[in] iFormat

Gibt das Format der Bitmap in Bezug auf die Anzahl der Bits von Farbinformationen pro Pixel an, die erforderlich sind. Dieser Parameter kann einer der folgenden Werte sein:

Wert Bedeutung
BMF_1BPP Monochrom
BMF_4BPP 4 Bits pro Pixel
BMF_8BPP 8 Bits pro Pixel
BMF_16BPP 16 Bits pro Pixel
BMF_24BPP 24 Bits pro Pixel
BMF_32BPP 32 Bits pro Pixel
BMF_4RLE 4 Bits pro Pixel; Ausführungslänge codiert
BMF_8RLE 8 Bits pro Pixel; Ausführungslänge codiert

[in] fl

Ist eine Bitmaske, die Eigenschaften der zu erstellenden Bitmap angibt. Dieser Parameter kann null oder eine beliebige Kombination der folgenden Werte sein:

Wert Bedeutung
BMF_NOZEROINIT GDI initialisiert die Bitmap bei der Zuordnung nicht mit null. Dieses Flag wird nur aktiviert, wenn pvBitsNULL ist.
BMF_TOPDOWN Die erste Scanzeile stellt den oberen Rand der Bitmap dar. Beachten Sie, dass Bitmaps im Standardformat standardmäßig die erste Scanzeile am unteren Rand aufweisen.
BMF_USERMEM GDI ordnet den Arbeitsspeicher für die Bitmap aus dem Benutzerspeicher zu. Standardmäßig wird der Arbeitsspeicher aus dem Adressraum des Kernels zugeordnet. Dieses Flag sollte nur angegeben werden, wenn die zu erstellende Bitmap von anderen Prozessen nicht verwendet wird. Der Benutzerspeicher kann vom Druckertreiber nicht an EngWritePrinter übergeben werden.

[in] pvBits

Zeiger auf die erste Scanzeile der zu erstellenden Bitmap. Wenn dieser Parameter NULL ist, weist GDI den Speicherplatz für die Pixel der Bitmap zu. Wenn pvBits nicht NULL ist, ist es ein Zeiger auf den Puffer für die Bitmap.

Rückgabewert

Wenn die Funktion erfolgreich abgeschlossen wurde, ist der Rückgabewert ein Handle, das die erstellte Bitmap identifiziert. Andernfalls ist der Rückgabewert 0. EngCreateBitmap protokolliert keinen Fehlercode.

Hinweise

Speicher für die Bitmap kann optional vom Treiber bereitgestellt werden.

Der Treiber sollte die erstellte Bitmap als Oberfläche zuordnen, indem er EngAssociateSurface aufruft , bevor er von DrvEnableSurface zurückkehrt.

Die Bitmap sollte mithilfe von EngDeleteSurface gelöscht werden, wenn sie nicht mehr benötigt wird.

Framepufferanzeigetreiber sollten den pvBits-Parameter verwenden, sodass GDI die meisten Zeichnungen direkt auf die Anzeige ausführen kann.

Anforderungen

   
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

DrvCreateDeviceBitmap

EngAllocUserMem