EngCreateDeviceBitmap-Funktion (winddi.h)

  • Artikel

Die EngCreateDeviceBitmap-Funktion fordert GDI an, ein Handle für eine Gerätebitbitbit zu erstellen.

Syntax

ENGAPI HBITMAP EngCreateDeviceBitmap(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

Parameter

[in] dhsurf

Gerätehandle für die zu erstellende Gerätebit.

[in] sizl

Gibt eine SIZEL-Struktur an, die die Breite und Höhe der zu erstellenden Bitmap enthält. Die Elemente cx und cy dieser Struktur enthalten jeweils die Breite und Höhe der Bitmap in Pixel. Eine SIZEL-Struktur ist mit einer SIZE-Struktur identisch.

iFormatCompat

Gibt das kompatible Engine-Format der zu erstellenden Geräteoberfläche an. Dies wird von GDI verwendet, wenn ein temporärer Puffer benötigt wird, um einen komplizierten Zeichnungsaufruf zu simulieren. Die zulässigen Werte für iFormatCompat sind BMF_1BPP, BMF_4BPP, BMF_8BPP, BMF_16BPP, BMF_24BPP und BMF_32BPP.

Rückgabewert

Der Rückgabewert ist ein Handle, das die Bitmap identifiziert, wenn die Funktion erfolgreich ist. Andernfalls ist er null, und ein Fehlercode wird protokolliert.

Hinweise

Die Oberfläche sollte mithilfe von EngAssociateSurface zugeordnet werden. Die Bitmap sollte durch Aufrufen von EngDeleteSurface gelöscht werden, wenn sie nicht mehr benötigt wird.

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

EngCreateBitmap