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 產生的內容句柄,可識別要為其產生目標模式清單的監視器。 在呼叫 iddCxMonitorCreate 之前,傳回這個 IDDCX_MONITOR 物件。
pInArgs
[in]IDARG_IN_QUERYTARGETMODES2 結構的指標,其中包含 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2所使用的輸入自變數。
pOutArgs
[out]IDARG_OUT_QUERYTARGETMODES 結構的指標,其中包含 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2所產生的輸出自變數。
傳回值
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 會傳回 NTSTATUS 值。 如果作業成功,它會傳回STATUS_SUCCESS或另一個狀態值,NT_SUCCESS(status) 等於 TRUE。 否則,它會傳回適當的NTSTATUS錯誤碼。
言論
此函式與 EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 類似,因為它可讓驅動程序報告相同的額外模式資訊。 支援 HDR 的驅動程式必須實作此函式;不支援 HDR 的驅動程式只能公開現有的 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES 函式。
IDDCX_TARGET_MODE2::BitsPerComponent 字段允許以單一模式報告多種格式和位深度。 例如,驅動程式可以藉由在 IDDCX_TARGET_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_WIRE_BITS_PER_COMPONENT。BitsPerComponent 参数如下:
- IDDCX_BITS_PER_COMPONENT_8以外的任何 Rgb 值, 或
- YCbCr444、YCbCr422或 YCbCr42 0 以外的任何值,IDDCX_BITS_PER_COMPONENT_NONE以外的任何值。
如需 HDR 支援的詳細資訊,請參閱 IddCx 1.10 版更新。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 11 版本 22H2 9 月更新 (IddCx 1.10 版) |
標頭 | iddcx.h |