Fungsi IddCxMonitorQueryHardwareCursor3 (iddcx.h)

Artikel
03/01/2024

Driver tampilan tidak langsung memanggil IddCxMonitorQueryHardwareCursor3 untuk mengambil informasi kursor perangkat keras saat ini untuk monitor yang ditentukan. Versi fungsi ini menambahkan tingkat putih SDR yang harus diterapkan driver ke kursor jika monitor berada dalam mode HDR.

Sintaks

HRESULT IddCxMonitorQueryHardwareCursor3(
  IDDCX_MONITOR                 MonitorObject,
  const IDARG_IN_QUERY_HWCURSOR *pInArgs,
  IDARG_OUT_QUERY_HWCURSOR3     *pOutArgs
);

Parameter

MonitorObject

[in] Objek IDDCX_MONITOR yang merupakan handel konteks OS monitor yang dibuat oleh IddCxMonitorCreate.

pInArgs

Penunjuk ke struktur IDARG_IN_QUERY_HWCURSOR yang berisi argumen input fungsi ini.

pOutArgs

Arahkan ke struktur IDARG_OUT_QUERY_HWCURSOR3 tempat informasi kursor perangkat keras monitor saat ini dikembalikan.

Nilai kembali

IddCxMonitorQueryHardwareCursor2 mengembalikan STATUS_SUCCESS setelah berhasil; jika tidak, ia mengembalikan kode kesalahan NTSTATUS yang sesuai. Kode kesalahan STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY adalah kesalahan sementara yang menunjukkan bahwa MonitorObject saat ini tidak berada di jalur aktif.

Keterangan

IddCxMonitorQueryHardwareCursor3 mengambil informasi kursor perangkat keras saat ini untuk monitor yang ditentukan dan menempatkannya ke dalam buffer yang disediakan pemanggil yang ditunjuk pOutArgs . Fungsi ini sangat mirip dengan IddCxMonitorQueryHardwareCursor2, tetapi juga memberikan nilai tingkat putih SDR. Tingkat putih SDR diperlukan karena semua gambar kursor dalam format SDR dan driver perlu memastikan gambar ditampilkan pada kecerahan yang benar.

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