Fungsi DrvCreateDeviceBitmap (winddi.h)
Fungsi DrvCreateDeviceBitmap membuat dan mengelola bitmap.
Sintaks
HBITMAP DrvCreateDeviceBitmap(
DHPDEV dhpdev,
SIZEL sizl,
ULONG iFormat
);
Parameter
dhpdev
Tangani ke PDEV yang menjelaskan perangkat fisik yang telah ditetapkan aplikasi sebagai target utama untuk bitmap. Format bitmap harus kompatibel dengan perangkat fisik ini.
sizl
Menentukan struktur SIZEL yang berisi lebar dan tinggi bitmap yang akan dibuat. Anggota cx dan cy dari struktur ini masing-masing berisi, lebar dan tinggi bitmap, dalam piksel. Struktur SIZEL identik dengan struktur SIZE .
iFormat
Menentukan format bitmap, yang menunjukkan jumlah bit informasi warna yang diperlukan per piksel, dan selalu cocok dengan format primer. Nilai ini bisa menjadi salah satu dari yang berikut ini:
| Nilai | Makna |
|---|---|
| BMF_8BPP | 8 bit per piksel. |
| BMF_16BPP | 16 bit per piksel. |
| BMF_24BPP | 24 bit per piksel. |
| BMF_32BPP | 32 bit per piksel. |
Nilai kembali
Nilai yang dikembalikan adalah handel yang mengidentifikasi bitmap yang dibuat jika fungsi berhasil. Jika driver memilih untuk membiarkan GDI membuat dan mengelola bitmap, nilai yang dikembalikan adalah nol. Jika terjadi kesalahan, nilai yang dikembalikan 0xFFFFFFFF, dan GDI mencatat kode kesalahan.
Keterangan
Jika driver membuat bitmap, driver dapat menyimpannya di mana saja dan dalam format apa pun. Diasumsikan bahwa driver akan memperhitungkan spesifikasi parameter dan memberikan bitmap setidaknya sebanyak bit per piksel seperti yang diminta.
Isi bitmap yang dibuat tidak terdefinisi.
Fungsi ini bersifat opsional. Namun, jika fungsi ini diimplementasikan, DrvDeleteDeviceBitmap juga harus diimplementasikan.
Persyaratan
| Target Platform | Desktop |
| Header | winddi.h (termasuk Winddi.h) |