CreateDiscardableBitmap-Funktion (wingdi.h)

Die CreateDiscardableBitmap-Funktion erstellt eine verworfene Bitmap, die mit dem angegebenen Gerät kompatibel ist. Die Bitmap hat das gleiche Bit-pro-Pixel-Format und die gleiche Farbpalette wie das Gerät. Eine Anwendung kann diese Bitmap als aktuelle Bitmap für ein Speichergerät auswählen, das mit dem angegebenen Gerät kompatibel ist.

Hinweis Diese Funktion wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Anwendungen sollten die Funktion CreateCompatibleBitmap verwenden.

 

Syntax

HBITMAP CreateDiscardableBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

Parameter

[in] hdc

Ein Handle für einen Gerätekontext.

[in] cx

Die Breite der Bitmap in Pixel.

[in] cy

Die Höhe der Bitmap in Pixel.

Rückgabewert

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

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

Hinweise

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

Weitere Informationen

Bitmapfunktionen

Übersicht über Bitmaps

CreateCompatibleBitmap

DeleteObject