DrvCreateDeviceBitmap-Funktion (winddi.h)

  • Artikel

Die DrvCreateDeviceBitmap-Funktion erstellt und verwaltet Bitmaps.

Syntax

HBITMAP DrvCreateDeviceBitmap(
  DHPDEV dhpdev,
  SIZEL  sizl,
  ULONG  iFormat
);

Parameter

dhpdev

Handle to the PDEV that beschreibt das physische Gerät, das eine Anwendung als primäres Ziel für eine Bitmap festgelegt hat. Das Format der Bitmap muss mit diesem physischen Gerät kompatibel sein.

sizl

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

iFormat

Gibt das Bitmapformat an, das die erforderliche Anzahl von Bits an Farbinformationen pro Pixel angibt und immer dem Format des primären entspricht. Die folgenden Werte sind möglich:

Wert Bedeutung
BMF_8BPP 8 Bits pro Pixel.
BMF_16BPP 16 Bits pro Pixel.
BMF_24BPP 24 Bits pro Pixel.
BMF_32BPP 32 Bits pro Pixel.

Rückgabewert

Der Rückgabewert ist ein Handle, das die erstellte Bitmap identifiziert, wenn die Funktion erfolgreich ist. Wenn der Treiber die Bitmap von GDI erstellen und verwalten lässt, ist der Rückgabewert 0. Wenn ein Fehler auftritt, wird der Rückgabewert 0xFFFFFFFF, und GDI protokolliert einen Fehlercode.

Hinweise

Wenn der Treiber die Bitmap erstellt, kann sie überall und in jedem Format gespeichert werden. Es wird davon ausgegangen, dass der Treiber die Spezifikationen der Parameter berücksichtigt und eine Bitmap mit mindestens so vielen Bits pro Pixel bereitstellt wie angefordert.

Der Inhalt der erstellten Bitmap ist nicht definiert.

Diese Funktion ist optional. Wenn diese Funktion implementiert ist, muss jedoch auch DrvDeleteDeviceBitmap implementiert werden.

Anforderungen

   
Zielplattform Desktop
Kopfzeile winddi.h (einschließlich Winddi.h)

Weitere Informationen

DrvDeleteDeviceBitmap