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,以報告 RGB 中每個元件的 8 和 10 位。 如果其他模式詳細數據也不同,驅動程式應該只報告每個元件的不同位作為唯一模式。
如果驅動程式尚未在 IddCxAdapterInitAsync 呼叫中回報 IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16,則傳回具有 SDR WCG 或 HDR 參數的模式將會失敗。 SDR WCG 和 HDR 參數可以是:
- IDDCX_BITS_PER_COMPONENT_8以外的任何 IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent.Rgb 值
- YCbCr444、YCbCr422或 YCbCr420IDDCX_BITS_PER_COMPONENT_NONE以外的任何 IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent 值。
如需 HDR 支援的詳細資訊,請參閱 IddCx 1.10 版更新。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 11 版本 22H2 9 月更新 (IddCx 1.10 版) |
標頭 | iddcx.h |