struktur IDARG_OUT_QUERY_HWCURSOR2 (iddcx.h)

Struktur IDARG_OUT_QUERY_HWCURSOR2 adalah parameter output yang digunakan oleh IddCxMonitorQueryHardwareCursor2 untuk mengembalikan informasi tentang kursor perangkat keras saat ini.

Sintaks

struct IDARG_OUT_QUERY_HWCURSOR2 {
  BOOL                    IsCursorVisible;
  INT                     X;
  INT                     Y;
  BOOL                    IsCursorShapeUpdated;
  IDDCX_CURSOR_SHAPE_INFO CursorShapeInfo;
  BOOL                    PositionValid;
  UINT                    PositionId;
};

Anggota

IsCursorVisible

[out] Nilai Boolean yang menunjukkan apakah kursor terlihat.

X

[out] Jika kursor terlihat (IsCursorVisible = TRUE) maka X adalah koordinat layar x dari piksel kiri atas dalam gambar kursor. Bidang ini hanya valid jika PositionValid ADALAH TRUE. X bisa negatif; misalnya, ketika hot spot di tengah kursor ditempatkan di kiri atas layar.

Y

[out] Jika kursor terlihat (IsCursorVisible = TRUE) maka Y adalah koordinat layar y dari piksel kiri atas dalam gambar kursor. Bidang ini hanya valid jika PositionValid ADALAH TRUE. Y bisa negatif; misalnya, ketika hot spot di tengah kursor ditempatkan di kiri atas layar.

IsCursorShapeUpdated

[out] Nilai Boolean yang menunjukkan apakah bentuk kursor telah diperbarui sejak terakhir kali driver bernama IddCxMonitorQueryHardwareCursor2. Jika telah diperbarui, OS memperbarui struktur CursorShapeInfo dan menyalin data gambar kursor baru ke dalam IDARG_IN_QUERY_HWCURSOR. buffer pShapeBuffer .

CursorShapeInfo

[out] Struktur IDDCX_CURSOR_SHAPE_INFO di mana OS menyalin informasi kursor saat ini jika kursor terlihat. Jika kursor tidak terlihat, MAKA OS nol struktur ini.

PositionValid

[out] Nilai Boolean yang menunjukkan apakah bidang X, Y, dan PositionId dalam struktur ini valid.

PositionId

[out] ID posisi kursor terakhir yang diterima OS untuk monitor ini. Driver dapat membandingkan ID ini dengan posisi kursor terakhir yang diproses untuk mengetahui apakah harus memproses pembaruan posisi baru.

Perhatikan bahwa ada kasus di mana nilai posisi mungkin tidak berubah tetapi nilai ID posisi telah berubah. Dalam hal ini driver harus memproses posisi seolah-olah itu adalah langkah baru. PositionId tidak diperbarui jika IsCursorVisible berubah dan hanya valid jika PositionValid TRUE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11, versi 22H2
Header	iddcx.h

Lihat juga

IddCxMonitorQueryHardwareCursor2