Compartir a través de

enumeración IDDCX_ADAPTER_FLAGS (iddcx.h)

IDDCX_ADAPTER_FLAGS especifica las marcas de funcionalidad booleana para un adaptador de pantalla indirecto.

Sintaxis

typedef enum IDDCX_ADAPTER_FLAGS {
  IDDCX_ADAPTER_FLAGS_NONE = 0,
  IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE = 0x1,
  IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS = 0x2,
  IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER = 0x4,
  IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS = 0x8,
  IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION = 0x10,
  IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS = 0x20,
  IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 = 0x40,
  IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE = 0x80
} ;

Constantes

 
IDDCX_ADAPTER_FLAGS_NONE
Valor: 0
Indica que no hay marcas establecidas para el adaptador.
IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE
Valor: 0x1
El modelo de visualización indirecta admite automáticamente los modos virtuales del sistema operativo, lo que permite que el sistema operativo realice cambios de modo sin problemas mediante el escalado del Administrador de ventanas de escritorio (DWM) por fotograma sin cambiar el modo de visualización. Una desventaja se produce cuando el usuario usa un modo de escritorio más pequeño: la imagen de escritorio proporcionada al controlador es mayor que el tamaño del escritorio, lo que reduce el ancho de banda de codificación y transmisión.

Este valor de enumeración indica al sistema operativo que use el tamaño de superficie de escritorio más pequeño posible cuando se cambie el modo de escritorio. Una solución que tenga una sobrecarga de procesamiento grande o ancho de banda de transmisión limitado normalmente usa esta marca para reducir el tamaño de la imagen de escritorio para procesar tanto como sea posible.

Establecer esta marca da como resultado un cambio en modo cada vez que se cambia la resolución del escritorio.
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS
Valor: 0x2
Esta marca estaba en desuso a partir de IddCx v1.7. Los controladores todavía pueden establecer esta marca para IddCx 1.7 y versiones posteriores, pero no tendrá ningún efecto. Si un controlador está diseñado para ejecutarse en pre-IddCx 1.7 y establece esta marca, ese controlador debe tener la lógica para procesar los movimientos; De lo contrario, los usuarios verán problemas visuales al ejecutarse en sistemas anteriores a IddCx 1.7.

Indica si el controlador puede usar regiones de movimiento proporcionadas por el sistema operativo además de rects sucios al codificar la imagen. El controlador solo debe establecerlo en TRUE si usa las regiones de movimiento porque el sistema operativo incurre en un costo al generar estos recursos adicionales. Si el controlador establece esto en FALSE, el sistema operativo convierte todas las regiones de movimiento en rects sucios.
IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER
Valor: 0x4
Indica si el controlador es un controlador de sesión remoto que admite monitores de sesión remotos, en lugar de monitores de sesión de consola. Un controlador de sesión remota no puede admitir monitores de sesión de consola y un controlador de sesión de consola no puede admitir monitores de sesión remotos. Se admite a partir de IddCx versión 1.4.
IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS
Valor: 0x8
Indica que el controlador prefiere usar memoria físicamente contigua para los búferes de cadena de intercambio, lo que permite al controlador examinar directamente los búferes sin necesidad de una copia intermedia. Se admite a partir de IddCx versión 1.6.
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION
Valor: 0x10
Indica que el controlador quiere recibir todos los cambios de posición del cursor; es decir, quiere recibir la entrada del mouse insertada en la sesión remota desde el cliente remoto y los movimientos de procedimientos causados por una llamada API desde una aplicación o el sistema operativo en el servidor.

Esta marca solo es válida cuando se combina con IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER. iddCxAdapterInitAsync producirá un error si se establece IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION sin IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER.

Se admite a partir de IddCx versión 1.7.
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS
Valor: 0x20
Un controlador que establece esta marca solicita al sistema operativo que realice un seguimiento de las regiones desfasadas de las actualizaciones de escritorio con mayor precisión. Este seguimiento más preciso tiene una pequeña sobrecarga de uso de CPU, por lo que los controladores solo deben establecer esta marca si las regiones sucias más pequeñas son beneficiosas para el controlador.

Se admite a partir de IddCx versión 1.8.
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16
Indica que el controlador puede procesar superficies de cadena de intercambio de punto flotante de precisión media (FP16) ieee. Un controlador debe establecer IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 incluso para adaptadores que no admiten WCG HDR o SDR. El sistema operativo envía superficies y modos WC HDR o SDR al controlador cuando la combinación correcta de monitor, capacidades de destino, configuración de sistema operativo, etc. están en su lugar. Por lo tanto, un controlador que establece IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 también debe admitir las funciones IddCx versión 1.10 que permiten que esto suceda. Un controlador que admita HDR10 debe ser capaz de:

* Superficies de formato FP16 de recepción y procesamiento dentro de una cadena de intercambio.
* Aplicar el nivel de blanco de SDR indicado a los cursores del mouse.

Los controladores de consola también deben:

* Use la nueva transformación de color de matriz 3x4.
* Acepte y use metadatos HDR.

Los controladores remotos también deben:

* Proporcione colorimetría y nivel blanco de SDR cuando sea necesario.

Se admite a partir de IddCx versión 1.10. Vea comentarios.
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE
Valor: 0x80
Solo los controladores remotos pueden establecer esta marca.

Los controladores remotos pueden usar IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE para permitirles especificar los modos de destino que no forman parte de un descriptor de supervisión. Normalmente, el sistema operativo elige un modo basado en que se encuentra en la lista de modo de supervisión y destino, notificado a través de EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION o EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES si no hay ningún descriptor disponible y la lista de modo de destino. Los escenarios remotos pueden requerir modos que no estén en el descriptor. En su lugar, el controlador puede usar modos de destino para describirlos e indicar al sistema operativo que no deben comprobarse con los modos de supervisión.

Cuando un controlador remoto establece esta marca, indica que se garantiza que todos los modos de destino notificados en llamadas a EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 y iddCxMonitorUpdateModes2 se garantiza que sean compatibles con el monitor conectado actualmente. A continuación, el sistema operativo no llamará a EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 ni EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES.

Se admite a partir de IddCx versión 1.10. Vea comentarios.

Observaciones

Para determinar si el sistema operativo acepta la configuración de controladores IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 o IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE, el controlador debe usar la macro IDD_IS_FUNCTION_AVAILABLE para comprobar la presencia de uno de los DDIs de la versión 1.10; por ejemplo, IDD_IS_FUNCTION_AVAILABLE(IddCxSwapChainReleaseAndAcquireBuffer2). Esta macro se evalúa como TRUE en un sistema operativo compatible con v1.10 y false en caso contrario. Consulte Actualizaciones para las versiones 1.10 y posteriores de IddCx para obtener más información.

Requisitos

Requisito Valor
encabezado de iddcx.h

Consulte también

IDDCX_ADAPTER_CAPS

IddCxAdapterInitAsync

  • Last updated on