Fungsi CreateBitmapIndirect (wingdi.h)

Artikel
08/27/2023

Fungsi CreateBitmapIndirect membuat bitmap dengan lebar, tinggi, dan format warna yang ditentukan (bidang warna dan bit-per-piksel).

Sintaks

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

Parameter

[in] pbm

Penunjuk ke struktur BITMAP yang berisi informasi tentang bitmap. Jika aplikasi mengatur anggota bmWidth atau bmHeight ke nol, CreateBitmapIndirect mengembalikan handel ke piksel 1 demi 1, bitmap monokrom.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke bitmap.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Fungsi ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter input tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Bitmap terlalu besar agar memori dialokasikan.

Keterangan

Fungsi CreateBitmapIndirect membuat bitmap yang bergantung pada perangkat.

Setelah bitmap dibuat, bitmap dapat dipilih ke dalam konteks perangkat dengan memanggil fungsi SelectObject . Namun, bitmap hanya dapat dipilih ke dalam konteks perangkat jika bitmap dan DC memiliki format yang sama.

Sementara fungsi CreateBitmapIndirect dapat digunakan untuk membuat bitmap warna, untuk alasan performa aplikasi harus menggunakan CreateBitmapIndirect untuk membuat bitmap monokrom dan CreateCompatibleBitmap untuk membuat bitmap warna. Setiap kali bitmap warna dari CreateBitmapIndirect dipilih ke dalam konteks perangkat, sistem harus memastikan bahwa bitmap cocok dengan format konteks perangkat yang dipilih. Karena CreateCompatibleBitmap mengambil konteks perangkat, createCompatibleBitmap mengembalikan bitmap yang memiliki format yang sama dengan konteks perangkat yang ditentukan. Dengan demikian, panggilan berikutnya ke SelectObject lebih cepat dengan bitmap warna dari CreateCompatibleBitmap daripada dengan bitmap warna yang dikembalikan dari CreateBitmapIndirect.

Jika bitmap monokrom, nol mewakili warna latar depan dan yang mewakili warna latar belakang untuk konteks perangkat tujuan.

Saat Anda tidak lagi memerlukan bitmap, panggil fungsi DeleteObject untuk menghapusnya.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll