通过

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 (状态) 等于 TRUE。 否则，它将返回相应的 NTSTATUS 错误代码。

注解

此函数类似于 EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 ，因为它允许驱动程序报告相同的额外模式信息。 支持 HDR 的驱动程序必须实现此函数;不支持 HDR 的驱动程序只能公开现有的 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES 函数。

IDDCX_TARGET_MODE2：：BitsPerComponent 字段允许在单个模式下报告多种格式和位深度。 例如，驱动程序可以通过将 IDDCX_BITS_PER_COMPONENT_8 和 IDDCX_BITS_PER_COMPONENT_10 设置为 IDDCX_TARGET_MODE2：：BitsPerComponent：：Rgb 来报告每个组件的 8 位和 10 位。 如果其他模式详细信息也不同，驱动程序应仅将每个组件的不同位报告为唯一模式。

如果返回具有 SDR WCG 或 HDR 参数的模式的驱动程序未在 IddCxAdapterInitAsync 调用中报告IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16，则会失败。 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

另请参阅

IDARG_IN_QUERYTARGETMODES2

IDARG_OUT_QUERYTARGETMODES