EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2回调函数 (iddcx.h)
OS 调用 EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 要求驱动程序将监视器说明分析为监视器支持的模式列表。 OS 调用此回调版本(而不是 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(status) 等于 TRUE。 否则,它将返回适当的 NTSTATUS 错误代码。
言论
支持 HDR 的版本 1.10 或更高版本的间接显示驱动程序必须将此函数公开为报表模式。 设置以下 IDDCX_WIRE_BITS_PER_COMPONENT 值等效于通过 1.10 之前的函数创建模式:
- BitsPerComponent.RgbIDDCX_BITS_PER_COMPONENT_8
- BitsPerComponent.YCbCr444、BitsPerComponent.YCbCr422 和 BitsPerComponent.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_8 和 IDDCX_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.Rgb 除 IDDCX_BITS_PER_COMPONENT_8以外的任何值,或
- YCbCr444、YCbCr422或 YCbCr420(IDDCX_BITS_PER_COMPONENT_NONE)的任何 IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent 值。
有关 HDR 支持的详细信息,请参阅 IddCx 版本 1.10 更新。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 11 版本 22H2 9 月更新(IddCx 版本 1.10) |
标头 | iddcx.h |