Fungsi DrvIcmCheckBitmapBits (winddi.h)
Fungsi DrvIcmCheckBitmapBits memeriksa apakah piksel dalam bitmap yang ditentukan terletak dalam gamut perangkat dari transformasi yang ditentukan.
Sintaks
BOOL DrvIcmCheckBitmapBits(
DHPDEV dhpdev,
HANDLE hColorTransform,
SURFOBJ *pso,
PBYTE paResults
);
Parameter
dhpdev
Tangani ke PDEV perangkat fisik.
hColorTransform
Tangani ke transformasi warna tempat bitmap akan diperiksa. Transformasi ini dibuat oleh driver melalui panggilan sebelumnya ke rutinitas DrvIcmCreateColorTransform .
pso
Arahkan ke SURFOBJ yang berisi permukaan bitmap yang akan diperiksa.
paResults
Arahkan ke array byte tempat driver mengembalikan hasil pengujian. GDI mengalokasikan buffer ini untuk berisi setidaknya sebanyak byte karena ada piksel dalam bitmap. Driver tidak perlu melakukan alokasi atau pemeriksaan terikat sebelum menulis ke array.
Nilai kembali
DrvIcmCheckBitmapBits mengembalikan TRUE setelah berhasil. Jika tidak, ia melaporkan kesalahan dan mengembalikan FALSE.
Keterangan
Setiap byte dalam array tempat titik paResults sesuai dengan piksel dalam bitmap. Untuk setiap piksel, driver menentukan apakah nilai warnanya ada di gamut perangkat dan kemudian menulis nilai antara nol dan 255 dalam byte array yang sesuai. Nilai memiliki arti berikut:
| Nilai | Makna |
|---|---|
| Nol | Warnanya ada di gamut perangkat. |
| Bukan nol | Warnanya di luar gamut. Nilai n+1 menunjukkan bahwa warna setidaknya sejauh dari gamut sebagai nilai n. |
DrvIcmCheckBitmapBits dapat diimplementasikan secara opsional dalam driver yang mendukung ICM. Driver menunjukkan dukungan untuk ICM dengan mengatur bendera GCAPS_ICM di anggota flGraphicsCaps dari struktur DEVINFO .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | winddi.h (termasuk Winddi.h) |