CreateBitmapIndirect-Funktion (wingdi.h)

Artikel
08/27/2023

Die CreateBitmapIndirect-Funktion erstellt eine Bitmap mit der angegebenen Breite, Höhe und dem angegebenen Farbformat (Farbebenen und Bits pro Pixel).

Syntax

HBITMAP CreateBitmapIndirect(
  [in] const BITMAP *pbm
);

Parameter

[in] pbm

Ein Zeiger auf eine BITMAP-Struktur , die Informationen zur Bitmap enthält. Wenn eine Anwendung die Elemente bmWidth oder bmHeight auf null festlegt, gibt CreateBitmapIndirect das Handle auf eine monochrome Bitmap mit 1 x 1 Pixel zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Bitmap.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Diese Funktion kann die folgenden Werte zurückgeben.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Mindestens ein Eingabeparameter ist ungültig.
ERROR_NOT_ENOUGH_MEMORY	Die Bitmap ist zu groß, damit Arbeitsspeicher zugewiesen werden kann.

Hinweise

Die CreateBitmapIndirect-Funktion erstellt eine geräteabhängige Bitmap.

Nachdem eine Bitmap erstellt wurde, kann sie in einem Gerätekontext ausgewählt werden, indem die SelectObject-Funktion aufgerufen wird. Die Bitmap kann jedoch nur in einem Gerätekontext ausgewählt werden, wenn die Bitmap und der DC das gleiche Format haben.

Während die CreateBitmapIndirect-Funktion zum Erstellen von Farb bitmaps verwendet werden kann, sollten Anwendungen aus Leistungsgründen CreateBitmapIndirect verwenden, um monochrome Bitmaps und CreateCompatibleBitmap zum Erstellen von Farbbitbitmaps zu erstellen. Wenn eine FarbbitmapIndirect in einem Gerätekontext ausgewählt wird, muss das System sicherstellen, dass die Bitmap dem Format des ausgewählten Gerätekontexts entspricht. Da CreateCompatibleBitmap einen Gerätekontext verwendet, wird eine Bitmap zurückgegeben, die das gleiche Format wie der angegebene Gerätekontext aufweist. Daher sind nachfolgende Aufrufe von SelectObject mit einer Farbbitbitmap aus CreateCompatibleBitmap schneller als mit einer Farbbitmap, die von CreateBitmapIndirect zurückgegeben wird.

Wenn die Bitmap monochrom ist, stellen Nullen die Vordergrundfarbe und die Hintergrundfarbe für den Zielgerätekontext dar.

Wenn Sie die Bitmap nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um sie zu löschen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll