EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 fungsi panggilan balik (iddcx.h)

OS memanggil EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 untuk mendapatkan daftar mode target yang didukung oleh driver untuk monitor yang terhubung ke titik akhir. Panggilan balik ini mirip dengan EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES, tetapi memungkinkan driver untuk melaporkan informasi tambahan untuk mode target HDR10 dan WCG.

Sintaks

EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 EvtIddCxMonitorQueryTargetModes2;

NTSTATUS EvtIddCxMonitorQueryTargetModes2(
  IDDCX_MONITOR MonitorObject,
  const IDARG_IN_QUERYTARGETMODES2 *pInArgs,
  IDARG_OUT_QUERYTARGETMODES *pOutArgs
)
{...}

Parameter

MonitorObject

[in] Handel konteks yang dihasilkan OS yang mengidentifikasi monitor untuk menghasilkan daftar mode target. Objek IDDCX_MONITOR ini dikembalikan dalam panggilan sebelumnya ke IddCxMonitorCreate.

pInArgs

[in] Penunjuk ke struktur IDARG_IN_QUERYTARGETMODES2 yang berisi argumen input yang digunakan oleh EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.

pOutArgs

[keluar] Penunjuk ke struktur IDARG_OUT_QUERYTARGETMODES yang berisi argumen output yang dihasilkan oleh EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.

Nilai kembali

EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 mengembalikan nilai NTSTATUS . Jika operasi berhasil, operasi mengembalikan STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE. Jika tidak, kode kesalahan NTSTATUS akan ditampilkan.

Keterangan

Fungsi ini mirip dengan EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 karena memungkinkan driver melaporkan informasi mode tambahan yang sama. Driver yang mendukung HDR harus menerapkan fungsi ini; driver yang tidak mendukung HDR hanya dapat mengekspos fungsi EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES yang ada.

Bidang IDDCX_TARGET_MODE2::BitsPerComponent memungkinkan beberapa format dan kedalaman bit dilaporkan dalam satu mode. Misalnya, driver dapat melaporkan 8 dan 10 bit per komponen di RGB dengan mengatur IDDCX_BITS_PER_COMPONENT_8 dan IDDCX_BITS_PER_COMPONENT_10 di IDDCX_TARGET_MODE2::BitsPerComponent::Rgb. Driver hanya boleh melaporkan bit yang berbeda per komponen sebagai mode unik jika detail mode lain juga berbeda.

Driver yang mengembalikan mode dengan parameter SDR WCG atau HDR akan gagal jika belum juga melaporkan IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 dalam panggilan IddCxAdapterInitAsync . IDDCX_WIRE_BITS_PER_COMPONENT SDR WCG dan HDR . Parameter BitsPerComponent adalah:

• Nilai apa pun untuk Rgb selain IDDCX_BITS_PER_COMPONENT_8, atau
• Nilai apa pun untuk YCbCr444, YCbCr422, atau YCbCr420 selain IDDCX_BITS_PER_COMPONENT_NONE.

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

IDARG_IN_QUERYTARGETMODES2

IDARG_OUT_QUERYTARGETMODES