EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2回调函数 (iddcx.h)

OS 调用 EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 ,要求驱动程序将监视器说明解析为监视器支持的模式列表。 操作系统调用此回调版本 (而不是 EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION) ,以允许驱动程序报告 HDR10 或 WCG 监视模式所需的额外信息。

语法

EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 EvtIddCxParseMonitorDescription2;

NTSTATUS EvtIddCxParseMonitorDescription2(
  const IDARG_IN_PARSEMONITORDESCRIPTION2 *pInArgs,
  IDARG_OUT_PARSEMONITORDESCRIPTION *pOutArgs
)
{...}

参数

pInArgs

[in]指向包含此回调函数的输入参数 的IDARG_IN_PARSEMONITORDESCRIPTION2 结构的指针。

pOutArgs

[out]指向 IDARG_OUT_PARSEMONITORDESCRIPTION 结构的指针,该结构包含此回调函数的输出参数。

返回值

EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 返回 NTSTATUS 值。 如果操作成功,则返回STATUS_SUCCESS或NT_SUCCESS (状态) 等于 TRUE 的另一个状态值。 否则,它将返回相应的 NTSTATUS 错误代码。

注解

支持 HDR 的 1.10 或更高版本间接显示驱动程序必须将此函数公开给报表模式。 设置以下 IDDCX_WIRE_BITS_PER_COMPONENT 值等效于通过 1.10 之前的函数创建模式:

  • BitsPerComponent.RgbIDDCX_BITS_PER_COMPONENT_8
  • BitsPerComponent.YCbCr444BitsPerComponent.YCbCr422BitsPerComponent.YCbCr420IDDCX_BITS_PER_COMPONENT_NONE

未设置 IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 适配器标志的版本 1.10 及更高版本驱动程序可以继续仅报告 1.10 之前的函数。

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

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

  • IDDCX_BITS_PER_COMPONENT_8 以外的IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent.Rgb 的任何值,或
  • YCbCr444、YCbCr422YCbCr420 的任何IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent 值(IDDCX_BITS_PER_COMPONENT_NONE)。

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

要求

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

另请参阅

IDARG_IN_PARSEMONITORDESCRIPTION2

IDARG_OUT_PARSEMONITORDESCRIPTION