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 |