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 presentación.
pInArgs
[in] Puntero a una estructura IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 que contiene argumentos de entrada a la función.
Valor devuelto
IddCxAdapterDisplayConfigUpdate2 devuelve STATUS_SUCCESS al éxito; de lo contrario, devuelve un código de error adecuado.
Comentarios
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 forma que no toda la información se debe proporcionar en todas las llamadas. 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 se podría llamar a IddCxAdapterDisplayConfigUpdate2 para actualizar solo el nivel de blanco de SDR si no se requiere ningún cambio de diseño.
Los modos de control (establecer la marca 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 activas que no estén en la lista de rutas de acceso quedarán inactivas.
- Si solo se establecen marcas que no son de IDDCX_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 necesiten 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 llamadas posteriores a IddCxAdapterDisplayConfigUpdate2
La primera vez que se incluye una ruta de acceso en una llamada IddCxAdapterDisplayConfigUpdate2 tiene requisitos diferentes a los tiempos posteriores. En la tabla siguiente se describen los requisitos.
| Campo Ruta de acceso | Requerido 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? |
|---|---|---|---|
| Mode | Sí | Sí | QueryDisplayConfig proporcionará la configuración de visualización del cliente y se enviará WM_DISPLAYCHANGE cuando se muestren los cambios de configuració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 pasa ningún EDID | No | No es necesario si se pasa EDID |
| Colorimetría | Sí para el modo de color que no es SDR | Sí | Mayoría de los campos de AdvancedColorInfo correspondientes |
| 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 actualización de septiembre de la versión 22H2 difiere ligeramente de cuando se ejecuta en la versión de la plataforma Windows que viene en 2024. Un controlador puede usar la función IddCxGetVersion para 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 de septiembre Actualiza los posibles modos de color | Versión de plataforma en 2024 posibles modos de color |
|---|---|---|
| None | 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 IddCxAdapterDisplayConfigUpdate2 . 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 del Monitor 1
| Monitor | Marcas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Ningún cambio en los datos del modo actual |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Ningún cambio en los datos del modo actual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Cambiar la posición del escritorio a -3840 0 |
Escenario 2: cambio del monitor 2 de SDRWCG a SDR
| Monitor | Marcas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | 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 | Ningún cambio en los datos del modo actual |
Escenario 3: cambio del monitor 1 de SDR a HDR
| Monitor | Marcas | 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 | Ningún cambio en los datos del modo actual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Ningún cambio en los datos del modo actual |
Escenario 4: cambio del factor de escala de Monitor 2
| Monitor | Marcas | 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 | Marcas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Ningún cambio en los datos del modo actual |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Sin cambios en los datos del modo actual, establezca un nuevo factor de escala |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Cambiar la posición del escritorio a -3840 0 |
Escenario 6: Quitar monitor 2 de la configuración actual
| Monitor | Marcas | Detalles |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Ningún cambio en los datos del modo actual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Ningún cambio en los datos del modo actual |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 22H2, actualización de septiembre (IddCx versión 1.10) |
| Encabezado | iddcx.h |