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.Rgb 到 IDDCX_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来报告 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、YCbCr422 或 YCbCr420 的任何IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent 值(IDDCX_BITS_PER_COMPONENT_NONE)。
有关 HDR 支持的详细信息,请参阅 IddCx 版本 1.10 更新。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 11,版本 22H2 9 月更新 (IddCx 版本 1.10) |
标头 | iddcx.h |