struktur IDARG_OUT_QUERY_HWCURSOR3 (iddcx.h)

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

Sintaks

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

Anggota

IsCursorVisible

[keluar] Nilai Boolean yang menunjukkan apakah kursor terlihat.

X

[keluar] 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

[keluar] 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

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

CursorShapeInfo

[keluar] 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

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

PositionId

[keluar] ID posisi kursor terakhir yang diterima OS untuk monitor ini. Driver dapat membandingkan ID ini dengan posisi kursor terakhir yang diproses untuk mengetahui apakah ia 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.

SdrWhiteLevel

[keluar] Tingkat putih untuk kursor, dalam nits, yang akan digunakan saat menyusun dengan konten HDR.

Keterangan

Untuk informasi selengkapnya tentang dukungan HDR, lihat Pembaruan IddCx versi 1.10.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11, Pembaruan September versi 22H2 (IddCx versi 1.10)
Header	iddcx.h

Lihat juga

IddCxMonitorQueryHardwareCursor3