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)

Lihat juga

DrvDeleteDeviceBitmap