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