Fungsi DrvRealizeBrush (winddi.h)

Artikel
08/27/2023

Fungsi DrvRealizeBrush meminta agar driver mewujudkan kuas tertentu untuk permukaan tertentu.

Sintaks

BOOL DrvRealizeBrush(
  [in]           BRUSHOBJ *pbo,
  [in, out]      SURFOBJ  *psoTarget,
  [in]           SURFOBJ  *psoPattern,
  [in, optional] SURFOBJ  *psoMask,
  [in]           XLATEOBJ *pxlo,
  [in]           ULONG    iHatch
);

Parameter

[in] pbo

Arahkan ke struktur BRUSHOBJ yang akan diwujudkan. Semua parameter lainnya, kecuali untuk psoTarget, dapat dikueri dari objek ini. Spesifikasi parameter disediakan sebagai pengoptimalan. Parameter ini paling baik digunakan hanya sebagai parameter untuk BRUSHOBJ_pvAllocRbrush, yang mengalokasikan memori untuk kuas yang direalisasikan.

[in, out] psoTarget

Arahkan ke struktur SURFOBJ yang kuasnya akan diwujudkan. Permukaan ini bisa menjadi permukaan fisik untuk perangkat, bitmap format perangkat, atau bitmap format standar.

[in] psoPattern

Arahkan ke struktur SURFOBJ yang menjelaskan pola untuk kuas. Untuk perangkat raster, ini adalah bitmap. Untuk perangkat vektor, ini adalah salah satu permukaan pola yang disediakan oleh DrvEnablePDEV.

[in, optional] psoMask

Arahkan ke struktur SURFOBJ yang menjelaskan masker transparansi untuk kuas. Ini adalah bitmap 1 bit per piksel yang memiliki tingkat yang sama dengan pola. Masker nol berarti piksel dianggap sebagai piksel latar belakang untuk kuas. (Dalam mode latar belakang transparan, piksel latar belakang tidak terpengaruh dalam isian.) Plotter dapat mengabaikan parameter ini karena tidak pernah menggambar informasi latar belakang.

[in] pxlo

Penunjuk ke struktur XLATEOBJ yang menentukan interpretasi warna dalam pola. Jika pxloNULL, tidak diperlukan terjemahan. Rutinitas layanan XLATEOBJ_Xxx dapat dipanggil untuk menerjemahkan warna ke indeks warna perangkat. Perangkat vektor harus menerjemahkan warna nol melalui XLATEOBJ untuk mendapatkan warna latar depan untuk kuas.

[in] iHatch

Menentukan apakah psoPattern adalah salah satu kuas hatch yang dikembalikan oleh DrvEnablePDEV. Ini benar jika nilai parameter ini kurang dari HS_DDI_MAX, yang didefinisikan dalam winddi.h.

Mengembalikan nilai

Nilai yang dikembalikan adalah TRUE jika kuas berhasil direalisasikan. Jika tidak, itu FALSE, dan kode kesalahan dicatat.

Keterangan

Untuk mewujudkan kuas, pengemudi mengubah sikat GDI menjadi bentuk yang dapat digunakan secara internal. Kuas yang disadari berisi informasi khusus perangkat yang diperlukan oleh perangkat untuk mempercepat menggambar menggunakan kuas.

Realisasi pengemudi dari kuas ditulis ke dalam buffer yang dialokasikan oleh panggilan ke BRUSHOBJ_pvAllocRbrush.

DrvRealizeBrush diperlukan untuk pengemudi yang melakukan gambar apa pun ke permukaan apa pun.