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]指向包含 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2使用的输入参数的 IDARG_IN_QUERYTARGETMODES2 结构的指针。

pOutArgs

[out]指向包含由 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2生成的输出参数的 IDARG_OUT_QUERYTARGETMODES 结构的指针。

返回值

EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 返回 NTSTATUS 值。 如果作成功,它将返回STATUS_SUCCESS或其他状态值,NT_SUCCESS(status) 等于 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_8IDDCX_BITS_PER_COMPONENT_10 来报告每个组件的 8 位和 10 位。 如果其他模式详细信息也不同,驱动程序应仅将每个组件的不同位报告为唯一模式。

如果驱动程序在 IddCxAdapterInitAsync 调用中未报告 IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16,则返回 SDR WCG 或 HDR 参数的模式将失败。 SDR WCG 和 HDR IDDCX_WIRE_BITS_PER_COMPONENT。BitsPerComponent 参数为:

  • RgbIDDCX_BITS_PER_COMPONENT_8以外的任何值,或
  • YCbCr444YCbCr422或除 IDDCX_BITS_PER_COMPONENT_NONE以外的 YCbCr420 的任何值。

有关 HDR 支持的详细信息,请参阅 IddCx 版本 1.10 更新。

要求

要求 价值
最低支持的客户端 Windows 11 版本 22H2 9 月更新(IddCx 版本 1.10)
标头 iddcx.h

另请参阅

IDARG_IN_QUERYTARGETMODES2

IDARG_OUT_QUERYTARGETMODES