Bitmap::UnlockBits-Methode (gdiplusheaders.h)

Artikel
02/29/2024

Die Bitmap::UnlockBits-Methode entsperrt einen Teil dieser Bitmap, der zuvor durch einen Aufruf von Bitmap::LockBits gesperrt wurde.

Syntax

Status UnlockBits(
  [in] BitmapData *lockedBitmapData
);

Parameter

[in] lockedBitmapData

Typ: BitmapData*

Zeiger auf ein BitmapData-Objekt , das zuvor an Bitmap::LockBits übergeben wurde.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Bitmap::LockBits und Bitmap::UnlockBits müssen als Paar verwendet werden. Durch einen Aufruf der Bitmap::LockBits-Methode eines Bitmap-Objekts wird ein temporärer Puffer eingerichtet, mit dem Sie Pixeldaten in einem angegebenen Format lesen oder schreiben können. Nachdem Sie in den temporären Puffer geschrieben haben, kopiert ein Aufruf von Bitmap::UnlockBits die Pixeldaten im Puffer in das Bitmap-Objekt . Wenn sich das Pixelformat des temporären Puffers vom Pixelformat des Bitmap-Objekts unterscheidet, werden die Pixeldaten entsprechend konvertiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll