Función IddCxAdapterDisplayConfigUpdate2 (iddcx.h)
Un controlador remoto puede llamar a iddCxAdapterDisplayConfigUpdate2 para permitir que un cliente indique al servidor cómo actualizar la configuración del monitor.
Sintaxis
HRESULT IddCxAdapterDisplayConfigUpdate2(
IDDCX_ADAPTER AdapterObject,
const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 *pInArgs
);
Parámetros
AdapterObject
[in] Objeto IDDCX_ADAPTER del adaptador remoto para el que se especifica la configuración de visualización.
pInArgs
[in] Puntero a una estructura de IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 que contiene argumentos de entrada a la función.
Valor devuelto
iddCxAdapterDisplayConfigUpdate2 devuelve STATUS_SUCCESS tras el éxito; de lo contrario, devuelve un código de error adecuado.
Observaciones
Un controlador de pantalla indirecto remoto puede llamar a IddCxAdapterDisplayConfigUpdate2 para establecer el modo, colorimetry y otros valores que el sistema operativo debe usar para un monitor específico. Solo los controladores remotos pueden llamar a esta función.
Para obtener más información sobre la compatibilidad con HDR, consulta actualizaciones de IddCx versión 1.10.
La estructura IDDCX_DISPLAYCONFIGPATH2 se define de tal manera que no se debe proporcionar toda la información en cada llamada. Por ejemplo, es posible que algunas rutas de acceso no proporcionen datos de colorimetría si el modo de color no es HDR o WCG, o iddCxAdapterDisplayConfigUpdate2 podría llamarse para actualizar solo el nivel blanco de SDR si no se requieren cambios de diseño.
Los modos de control (establecer la marca de IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID para una ruta de acceso) tienen algunas reglas y aclaraciones adicionales:
- Si alguna ruta de acceso tiene IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID establecer, todas las rutas de acceso proporcionadas deben tenerla establecida.
- Cuando se proporciona IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID en todas las rutas de acceso, las rutas de acceso actualmente activas que no estén en la lista de rutas de acceso quedarán inactivas.
- Si solo se establecen marcas que no son deIDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, solo deben estar presentes las rutas de acceso que se van a actualizar.
- Según el modo de color especificado, es posible que se requieran datos adicionales para una ruta de acceso. En la tabla siguiente se indica qué marcas adicionales se deben establecer:
| Modo de color | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID |
|---|---|---|
| SDR | No | No |
| SDRWCG | Sí | No |
| HDR | Sí | Sí |
Primero frente a las llamadas posteriores a IddCxAdapterDisplayConfigUpdate2
La primera vez que se incluye una ruta de acceso en un IddCxAdapterDisplayConfigUpdate2 llamada tiene requisitos diferentes a los tiempos posteriores. En la tabla siguiente se describen los requisitos.
| Campo Ruta de acceso | Obligatorio en la llamada inicial para la ruta de acceso | Se puede actualizar después de la llamada inicial | ¿Cómo obtendría el cliente de Windows la información? |
|---|---|---|---|
| Modo | Sí | Sí | QueryDisplayConfig proporcionará la configuración de visualización del cliente y WM_DISPLAYCHANGE se enviará cuando cambie la configuración de visualización; AdvancedColorInfo.CurrentAdvancedColorKind dará un modo de color |
| Factor de escala | Sí | Sí | Los controladores pueden usar el método usado para IddCxAdapterDisplayConfigUpdate |
| Tamaño físico | Sí si no se ha pasado ningún EDID | No | No es necesario si se pasa EDID |
| Colorimetría | Sí para el modo de color que no es SDR | Sí | La mayoría de los campos de AdvancedColorInfo correspondientes campos |
| Nivel de blanco de SDR | Sí para el modo de color HDR, el valor predeterminado es de 80 nits. | Sí | AdvancedColorInfo.SdrWhiteLevelInNits, consulta DirectX with Advanced Color on HDR/SDR displays para obtener más información |
Diferencias de comportamiento al ejecutarse en Windows 11, versión 22H2, actualización de septiembre
Debido a la funcionalidad subyacente del sistema operativo, la compatibilidad con controladores que solicitan modos de color HDR y WCG cuando se ejecuta en Windows 11, la versión 22H2 de la actualización de septiembre difiere ligeramente de cuando se ejecuta en la versión de la plataforma Windows que viene en 2024. Un controlador puede usar la funcióniddCxGetVersion depara determinar en qué sistema operativo se ejecutan. En la tabla siguiente se describen los modos de color que un controlador puede solicitar en función del descriptor de supervisión proporcionado anteriormente al sistema operativo:
| Tipo edid | 22H2 Septiembre Actualizar posibles modos de color | Versión de la plataforma en los modos de color posibles de 2024 |
|---|---|---|
| Ninguno | SDR, HDR | SDR, SDRWCG, HDR |
| SDR | SDR, SDRWCG | SDR, SDRWCG |
| HDR | SDR, HDR | SDR, SDRWCG, HDR |
Ejemplos
A continuación se indican algunos ejemplos de las rutas de acceso que se van a incluir en las siguientes llamadas IddCxAdapterDisplayConfigUpdate 2. Al principio de cada escenario, una sesión remota tiene configuradas las siguientes rutas de acceso:
| Monitor | Resolución | Posición del escritorio | Modo de color |
|---|---|---|---|
| 1 | 1920x1080 @ 30Hz | 0,0 | SDR |
| 2 | 1024x768 @ 30Hz | 1024,0 | SDRWCG |
| 3 | 3840x2160 @ 30Hz | 0,1848 | HDR |
Escenario 1: cambio de la posición de escritorio del Monitor 3 a la izquierda de Monitor 1
| Monitor | Banderas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Cambie la posición del escritorio a -3840 0 |
Escenario 2: cambio del monitor 2 de SDRWCG a SDR
| Monitor | Banderas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Establecer nuevo modo de color |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
Escenario 3: Cambio del monitor 1 de SDR a HDR
| Monitor | Banderas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID | Establecimiento del nuevo modo de color, colorimetría y nivel de blanco de SDR |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
Escenario 4: Cambio del factor de escala de Monitor 2
| Monitor | Banderas | Detalles |
|---|---|---|
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Establecimiento de un nuevo factor de escala |
Escenario 5: cambio del factor de escala de Monitor 2 y la posición de escritorio del Monitor 3 a la izquierda del Monitor 1
| Monitor | Banderas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | No hay ningún cambio en los datos del modo actual, establezca un nuevo factor de escala |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Cambie la posición del escritorio a -3840 0 |
Escenario 6: Quitar monitor 2 de la configuración actual
| Monitor | Banderas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | No hay ningún cambio en los datos del modo actual |
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Actualización de septiembre de Windows 11, versión 22H2 (IddCx, versión 1.10) |
| encabezado de | iddcx.h |