Fungsi EngSetPointerTag (winddi.h)
Fungsi EngSetPointerTag sudah usang untuk Windows 2000 dan versi sistem operasi yang lebih baru. Fungsi ini masih didukung, tetapi selalu mengembalikan FALSE.
EngSetPointerTag membuat bentuk yang digabungkan dengan bentuk penunjuk aplikasi pada panggilan DrvSetPointerShape ke driver terkait lainnya dalam sistem cermin.
Sintaks
ENGAPI BOOL EngSetPointerTag(
[in] HDEV hdev,
[in] SURFOBJ *psoMask,
[in] SURFOBJ *psoColor,
[in] XLATEOBJ *pxlo,
[in] FLONG fl
);
Parameter
[in] hdev
Tangani ke perangkat. Handel ini adalah handel GDI yang diterima oleh driver sebagai parameter hdev untuk DrvCompletePDEV.
[in] psoMask
Arahkan ke struktur SURFOBJ 1bpp yang menjelaskan komponen monokrom tag. Dimensi bitmap ini menentukan ukuran tag. Tidak ada batasan implisit pada ukuran tag, tetapi ukuran tag optimal adalah 32 x 32, 48 x 48, dan 64 x 64 piksel. GDI menghapus tag saat ini ketika nilai ini ADALAH NULL.
[in] psoColor
Arahkan ke struktur SURFOBJ dalam format warna yang sama dengan driver panggilan. Nilai ini bisa NULL jika tag tidak berisi komponen warna. Bitmap warna memiliki lebar yang sama dengan psoInputMask dan setengah tingginya.
[in] pxlo
Dicadangkan untuk penggunaan sistem; harus diatur ke NULL.
[in] fl
Dicadangkan untuk penggunaan sistem; harus diatur ke nol.
Mengembalikan nilai
EngSetPointerTag mengembalikan TRUE saat berhasil menerapkan tag. Jika tidak, ia mengembalikan FALSE. Untuk Windows 2000 dan yang lebih baru, fungsi ini selalu mengembalikan FALSE.
Keterangan
Driver kontrol jarak jauh dapat memanggil EngSetPointerTag untuk menandai bentuk penunjuk untuk menunjukkan kontrol sistem. Setelah driver kontrol jarak jauh mengatur tag, GDI akan secara otomatis menyusunnya dengan semua bentuk penunjuk yang dihasilkan oleh sistem, hingga driver menghapus atau mengubah tag.
Driver yang memanggil EngSetPointerShape tidak pernah mendapatkan tag sendiri yang diterapkan ke panggilan DrvSetPointerShape sendiri oleh GDI; hanya driver lain dalam sistem cermin yang menerapkan tag.
Jika psoColorNULL, psoMask menunjuk ke permukaan monokrom yang dua kali lebih tinggi dari lebarnya. Bagian atas mengandung monokrom DAN masker, dan bagian bawah berisi masker XOR monokrom.
Jika psoColor bukan NULL, psoMask hanya berisi monokrom DAN masker dan psoColor berisi permukaan XOR warna. Permukaan warna ini harus dalam format warna yang sama dengan driver. GDI menggabungkan bentuk dengan menjangkar sudut kiri atas setiap bitmap.
GDI membuat salinan psoMask dan psoColor, sehingga permukaan yang diteruskan oleh driver dapat segera dihapus setelah memanggil EngSetPointerTag.
Hasil EngSetPointerTag berlaku pada panggilan bentuk pointer berikutnya yang dihasilkan oleh sistem.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows. |
Target Platform | Universal |
Header | winddi.h (termasuk Winddi.h) |
Pustaka | Win32k.lib |
DLL | Win32k.sys |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk