EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2回呼函式 (iddcx.h)
OS 會呼叫 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 ，以取得驅動程式針對連線到端點的監視器所支援的目標模式清單。 此回呼類似於 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES，但可讓驅動程序報告 HDR10 和 WCG 目標模式的其他資訊。
語法
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 EvtIddCxMonitorQueryTargetModes2;
NTSTATUS EvtIddCxMonitorQueryTargetModes2(
IDDCX_MONITOR MonitorObject,
const IDARG_IN_QUERYTARGETMODES2 *pInArgs,
IDARG_OUT_QUERYTARGETMODES *pOutArgs
)
{...}
參數
MonitorObject
[in]OS 產生的內容句柄，可識別要為其產生目標模式清單的監視器。 這個 IDDCX_MONITOR 物件是在呼叫 IddCxMonitorCreate 之前傳回的。
pInArgs
[in] IDARG_IN_QUERYTARGETMODES2 結構的指標，其中包含 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2所使用的輸入自變數。
pOutArgs
[out] IDARG_OUT_QUERYTARGETMODES 結構的指標，其中包含 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2所產生的輸出自變數。
傳回值
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 傳回 NTSTATUS 值。 如果作業成功，它會傳回STATUS_SUCCESS或另一個狀態值，NT_SUCCESS (状态) 等於TRUE。 否則，它會傳回適當的NTSTATUS錯誤碼。
備註
此函式類似於 EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 ，其可讓驅動程序報告相同的額外模式資訊。 支援 HDR 的驅動程式必須實作此函式;不支援 HDR 的驅動程式只能公開現有的 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES 函式。
IDDCX_TARGET_MODE2：：BitsPerComponent 字段允許以單一模式報告多個格式和位深度。 例如，驅動程式可以藉由在 IDDCX_TARGET_MODE2：：BitsPerComponent：：Rgb 中設定 IDDCX_BITS_PER_COMPONENT_8 和 IDDCX_BITS_PER_COMPONENT_10，以 RGB 回報每個元件的 8 和 10 位。 如果其他模式詳細數據也不同，驅動程式應該只會針對每個元件回報不同的位作為唯一模式。
如果驅動程式尚未在IddCxAdapterInitAsync呼叫中回報IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16，則傳回具有SDR WCG 或 HDR 參數的模式將會失敗。 SDR WCG 和 HDR IDDCX_WIRE_BITS_PER_COMPONENT。BitsPerComponent 參數為：
- IDDCX_BITS_PER_COMPONENT_8以外的 Rgb 值，或
- 除了 IDDCX_BITS_PER_COMPONENT_NONE 以外，YCbCr444、YCbCr422 或 YCbCr420 的任何值。
如需 HDR 支援的詳細資訊，請參閱 IddCx 1.10 版更新。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 11 22H2 9 月更新 (IddCx 1.10 版) |
| 標頭 | iddcx.h |